jupyterlab_claude_code_extension
v1.0.50
Published
Browse, resume, and manage your Claude Code CLI sessions from a JupyterLab side panel. One click reactivates the right terminal - no duplicate tabs, live remote-control indicator, and favourites for the projects you keep coming back to.
Maintainers
Readme
jupyterlab_claude_code_extension
Manage Claude Code CLI sessions from inside JupyterLab. A left-sidebar panel lists every project under ~/.claude/projects/ deduplicated to one row per folder, marks live remote-control sessions with a green dot, and lets you jump back into any session by opening (or reactivating) a terminal pwd'd to that project and auto-running claude --resume <id>.

Features
- Three-section side panel - Favourites, Recent (top 10 by activity), and All. Each section scrolls independently; Favourites disappears when empty
- Live remote-control indicator - green dot on rows whose
~/.claude/sessions/<pid>.jsonis alive (verified viaos.kill(pid, 0)) - One-click resume - click a row to find an existing terminal pwd'd to that project (queried server-side from the pty's process tree) and reactivate its tab; only spawns a fresh terminal if none matches. Concurrent rapid clicks are coalesced
- Smart name resolution - shows the user-set
/renamename when available; auto-detected names (volatile across the samesessionIdor 3+ token lowercase-kebab) fall back to the folder basename. Toggle the behaviour via theresolveSessionNamessetting - Path-segment disambiguation - when two sessions share the same display name, the row reveals the minimum number of trailing path segments needed for each to be unique
- Favourites - star a session via the right-click menu; persisted server-side at
~/.claude/jupyterlab_claude_code_extension.json - Layout restorer - panel visibility persists across JupyterLab reloads
- Auto-disabled when the
claudebinary is not onPATH - Hover tooltip with relative path (vs JL root), last activity, message count, branch, first prompt, session id
Requirements
- JupyterLab >= 4.0.0
- Python >= 3.10
claudeCLI onPATH
Install
Developers must install via the project Makefile (which orchestrates clean, build, and pip install of the resulting wheel):
make installEnd-users can install the published package from PyPI:
pip install jupyterlab_claude_code_extensionUninstall
pip uninstall jupyterlab_claude_code_extension