Ipyclaude

ipyclaude

`ipyclaude` is an IPython extension that turns any input starting with `.` into an AI prompt.

It is aimed at terminal IPython, not notebook frontends.

Install

pip install ipyclaude

CLI

`ipyclaude` provides a standalone command that launches IPython with `ipyclaude` and `ipythonng` extensions pre-loaded and output history enabled:

ipyclaude

Resume a previous session:

ipyclaude -r        # interactive session picker
ipyclaude -r 43     # resume session 43 directly

On exit, `ipyclaude` prints the session ID so you can resume later.

Load As Extension

%load_ext ipyclaude

If you change the package in a running shell:

%reload_ext ipyclaude

How To Auto-Load `ipyclaude`

Add this to an `ipython_config.py` file used by terminal `ipython`:

c.TerminalIPythonApp.extensions = ["ipyclaude.core"]

Good places for that file include:

• env-local: {sys.prefix}/etc/ipython/ipython_config.py
• user-local: ~/.ipython/profile_default/ipython_config.py

In a virtualenv, the env-local path is usually `.venv/etc/ipython/ipython_config.py`.

To see which config paths your current `ipython` is searching, run:

ipython --debug -c 'exit()' 2>&1 | grep Searching

Usage

Only the leading period is special. There is no closing delimiter.

Single line:

.write a haiku about sqlite

Multiline paste:

.summarize this module:
focus on state management
and persistence behavior

Backslash-Enter continuation in the terminal:

.draft a migration plan \
with risks and rollback steps

`ipyclaude` also provides a line and cell magic named `%ipyclaude` / `%%ipyclaude`.

Note: `.01 * 3` and similar expressions starting with `.` followed by a digit will be interpreted as prompts. Write `0.01 * 3` instead.

Notes

Any IPython cell containing only a string literal is treated as a "note". Notes provide context to the AI without being e