jupyterlab-claude-code-extension 1.2.17

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.

jupyterlab_claude_code_extension

A full Claude Code launcher and manager for JupyterLab. Start, resume, fork, switch, and clean up Claude Code CLI sessions from a side panel - one click lands you in the right terminal with Claude already running, no duplicate tabs, no UUID hunting, with a live indicator showing which sessions are active right now.

Why this extension

One principle: Anthropic knows best how to build the agent harness; we know best how to make it work in JupyterLab.

Chat-panel extensions re-implement the agent loop and trail the real tool. This one runs the genuine, unmodified Claude Code CLI in JupyterLab terminals - skills, subagents, MCP, hooks, plan mode, every release the day it lands. The extension owns the JupyterLab side:

• Launching - new, resumed, or forked sessions, with or without permission prompts, no wrapper shell, correctly sized before Claude draws its first frame
• Finding - every Claude project in one panel: favourites, search, live activity
• Reusing - clicking a session focuses its existing terminal, never a duplicate
• Managing - parallel conversations: switch, fork with a name, delete - no --resume pickers, no raw UUIDs

Features

• Three-section side panel - Favorites, Recent, and All projects, each scrolling independently
• Live indicator - a green dot marks sessions that are currently running somewhere
• One-click resume - click a row to jump back into that session in a terminal. If a terminal for the project is already open, it's reused instead of duplicated
• Favorites - star projects you keep coming back to via the right-click menu
• Remove - drop a project's Claude history from the panel via the right-click menu; the history folder is moved to the trash (it honours JupyterLab's "move files to trash" setting), not deleted permanently
• Clean up parallel sessions - when a project has accumulated extra sessions beyond the main one, a right-click menu item (showing the count in brackets) removes them all, keeping only the main session; removed files honour the same trash setting
• Conversation switcher - a right-click "Switch and Manage Sessions" submenu lists a project's other conversations by name and short session id, e.g. home (3f2a1b9c), with last-activity time; pick one and it becomes the row's current conversation - the next click resumes exactly that one. The submenu shows the 5 most recent; "Manage Sessions..." opens a searchable popup over the full list where conversations can also be deleted - select one, many, or all via checkboxes, then confirm with a two-step Delete button (removed files honour the trash setting). Rows with multiple conversations show a branch icon with the count after the name
• Branch session - fork the current conversation into a new named session via the right-click menu (normal or skip-permissions mode); uses Claude's native --fork-session, opens in a new terminal, the chosen name is stamped automatically, and the fork becomes the row's current conversation
• Activity at a glance - each row shows its last activity (now, 5m ago, 2h ago, 3d ago) in an aligned column, with the favourite star in its own column beside it; rows active within the last minute light up in the theme's brand colour (including the now label), rows idle for over a week dim slightly
• Search - fuzzy filter toggled by the funnel button next to refresh
• Presentation modes - label rows by session name (so a /rename shows through), folder name, or path relative to the JupyterLab root
• Hover tooltip with project path, last activity, message count, branch, and session id
• Auto-disabled when the Claude Code CLI is not installed

Requirements

• JupyterLab >= 4.0.0
• Python >= 3.10
• claude CLI on PATH

Install

Developers must install via the project Makefile (which orchestrates clean, build, and pip install of the resulting wheel):

make install

End-users can install the published package from PyPI:

pip install jupyterlab_claude_code_extension

[!WARNING] package.json pins webpack: 5.106.0 and chalk: 4.1.2 in both resolutions and overrides. Do not remove these. webpack >= 5.106.1 changed its module-federation share identifier format and crashes the unmaintained license-webpack-plugin (split('=')[1].trim()) that @jupyterlab/builder injects into every production build; the duplicate chalk@2.4.2 pulled by duplicate-package-checker-webpack-plugin crashes on Node 24+ in the build-isolation install. Without the pins, make publish and CI fail on python -m build.

Claude statusline

The package ships a companion CLI that installs the claude-code-statusline powerline status line (context %, model, effort, git, env, pwd) into ~/.claude and points statusLine in settings.json at it - after asking for confirmation, since it downloads the script from that repo:

jupyterlab_claude_code install-claude-statusline

Uninstall

pip uninstall jupyterlab_claude_code_extension