jupyterlab_claude_code_extension 1.2.5 → 1.2.9

package/README.md

@@ -8,10 +8,21 @@
 [![Brought To You By KOLOMOLO](https://img.shields.io/badge/Brought%20To%20You%20By-KOLOMOLO-00ffff?style=flat)](https://kolomolo.com)
 [![Donate PayPal](https://img.shields.io/badge/Donate-PayPal-blue?style=flat)](https://www.paypal.com/donate/?hosted_button_id=B4KPBJDLLXTSA)
 
-Browse, resume, and manage your Claude Code sessions from a JupyterLab side panel. One click reactivates the right terminal, no duplicate tabs, with a live indicator showing which sessions are currently active.
+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.
 
 ![Claude Code Sessions panel](.resources/screenshot.png)
 
+## 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
@@ -20,7 +31,9 @@ Browse, resume, and manage your Claude Code sessions from a JupyterLab side pane
 - **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
-- **Switch conversation branch** - a right-click submenu lists a project's other conversations (5 most recent, with a searchable "More..." popup for longer lists) and switches the row's current one; rows with multiple conversations show the count in brackets after the name, e.g. `workspace (2)`
+- **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

package/lib/icons.d.ts

@@ -5,4 +5,5 @@ export declare const refreshIcon: LabIcon;
 export declare const removeIcon: LabIcon;
 export declare const shieldIcon: LabIcon;
 export declare const addIcon: LabIcon;
+export declare const branchIcon: LabIcon;
 export declare const filterIcon: LabIcon;

package/lib/icons.js

@@ -58,6 +58,15 @@ export const addIcon = new LabIcon({
     name: 'jupyterlab_claude_code_extension:add',
     svgstr: addSvgStr
 });
+// Git-branch glyph (Octicons git-branch-16, MIT) - marks rows that carry
+// parallel conversations and the Branch Session menu entries.
+const branchSvgStr = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16">
+  <path class="jp-icon3" fill="#616161" d="M9.5 3.25a2.25 2.25 0 1 1 3 2.122V6A2.5 2.5 0 0 1 10 8.5H6a1 1 0 0 0-1 1v1.128a2.251 2.251 0 1 1-1.5 0V5.372a2.25 2.25 0 1 1 1.5 0v1.836A2.493 2.493 0 0 1 6 7h4a1 1 0 0 0 1-1v-.628a2.25 2.25 0 0 1-1.5-2.122Zm-6 0a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0Zm8.25-.75a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5ZM4.25 12a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Z"/>
+</svg>`;
+export const branchIcon = new LabIcon({
+    name: 'jupyterlab_claude_code_extension:branch',
+    svgstr: branchSvgStr
+});
 // Funnel copied verbatim from @jupyterlab/ui-components'
 // `search/filter.svg` - the same image the file browser's filter
 // toggle uses. The `class="jp-icon3"` lets JupyterLab's theme drive

package/lib/types.d.ts

@@ -60,6 +60,13 @@ export interface ISwitchResponse {
     requested: string;
     current: string | null;
 }
+export interface IDeleteBranchesRequest {
+    encoded_path: string;
+    session_ids: string[];
+}
+export interface IDeleteBranchesResponse {
+    removed_count: number;
+}
 export interface ILaunchTerminalRequest {
     project_path: string;
     /** Omit to start a brand-new claude session instead of resuming one. */

package/lib/widget.d.ts

@@ -108,9 +108,30 @@ export declare class ClaudeCodeSessionsWidget extends Widget {
      * the project has more than one conversation. On a fetch failure the
      * menu opens without the submenu. */
     private _openContextMenu;
-    /** Popup with the project's full branch list - browse and filter when
-     * the list is too large for the submenu. Clicking an entry switches. */
+    /** Popup with the project's full branch list - browse, filter, switch
+     * and manage. Clicking an entry switches while nothing is selected;
+     * checkbox selection (one, many, or select-all) arms a two-step Delete
+     * button that removes the chosen sessions. The current conversation is
+     * shown first, badged and untouchable. */
     private _showBranchPopup;
+    /** Delete the given branch sessions of the active row's project.
+     * Returns the removed count, or null on failure (after notifying).
+     * Always resyncs the panel so the row's conversation count drops. */
+    private _deleteBranches;
+    /** Fork the active row's current conversation into a new named branch.
+     *
+     * Asks for a name, then launches a terminal running
+     * ``claude --resume <current> --fork-session --session-id <new uuid>`` -
+     * the uuid is generated here so the forked JSONL is known up front. Once
+     * claude materialises the file (polled via sessions/set-title) the chosen
+     * name is stamped as a custom-title record. The fork is the newest JSONL,
+     * so the recency resolution makes it the row's current conversation
+     * without an explicit switch.
+     */
+    private _branchSession;
+    /** Retry sessions/set-title until the forked JSONL exists (404 while it
+     * does not), then refresh so the row shows the named fork as current. */
+    private _stampForkTitle;
     /** Switch the active row's project to another conversation branch.
      * The backend touches the branch JSONL's mtime; a refresh then shows
      * the selected conversation as the row's current one. */
@@ -129,6 +150,7 @@ export declare class ClaudeCodeSessionsWidget extends Widget {
     private _contextMenu;
     private _branchSubmenu;
     private _lastBranches;
+    private _lastBranchesCurrent;
     private _newSessionMenu;
     private _activeSession;
     private _activeRowEl;

package/lib/widget.js

@@ -1,10 +1,11 @@
-import { Clipboard, Dialog, Notification, showDialog } from '@jupyterlab/apputils';
+import { Clipboard, Dialog, InputDialog, Notification, showDialog } from '@jupyterlab/apputils';
 import { ServerConnection } from '@jupyterlab/services';
 import { folderIcon, terminalIcon } from '@jupyterlab/ui-components';
 import { CommandRegistry } from '@lumino/commands';
+import { UUID } from '@lumino/coreutils';
 import { Menu, Widget } from '@lumino/widgets';
 import { requestAPI } from './request';
-import { addIcon, claudeIcon, filterIcon, refreshIcon, removeIcon, shieldIcon, starFilledIcon } from './icons';
+import { addIcon, branchIcon, claudeIcon, filterIcon, refreshIcon, removeIcon, shieldIcon, starFilledIcon } from './icons';
 const POLL_INTERVAL_MS = 30000;
 const DEFAULT_RECENT_LIMIT = 10;
 const EXPANDED_STORAGE_KEY = 'jupyterlab_claude_code_extension:expanded';
@@ -65,6 +66,7 @@ export class ClaudeCodeSessionsWidget extends Widget {
         this._sessions = null;
         this._expanded = loadExpanded();
         this._lastBranches = [];
+        this._lastBranchesCurrent = '';
         this._activeSession = null;
         this._activeRowEl = null;
         this._pollHandle = null;
@@ -783,6 +785,17 @@ export class ClaudeCodeSessionsWidget extends Widget {
         const row = document.createElement('div');
         row.className = 'jp-ClaudeSessionsPanel-row';
         row.title = this._buildRowTooltip(session);
+        // Age emphasis: active within the last minute reads bright, idle for
+        // over a week dims; the state decays/promotes on the next refresh.
+        if (session.file_mtime) {
+            const age = Date.now() - session.file_mtime;
+            if (age < 60000) {
+                row.classList.add('jp-mod-recentlyActive');
+            }
+            else if (age > 7 * 86400000) {
+                row.classList.add('jp-mod-stale');
+            }
+        }
         const removing = this._removingPaths.has(session.encoded_path);
         if (removing) {
             row.classList.add('jp-mod-busy');
@@ -806,20 +819,25 @@ export class ClaudeCodeSessionsWidget extends Widget {
         }
         const name = document.createElement('span');
         name.className = 'jp-ClaudeSessionsPanel-name';
-        // Conversation count in brackets - only when the project has branches.
-        name.textContent =
-            session.extra_sessions > 0
-                ? `${this._lookupName(session)} (${session.extra_sessions + 1})`
-                : this._lookupName(session);
-        row.appendChild(name);
-        if (session.file_mtime) {
-            const time = document.createElement('span');
-            time.className = 'jp-ClaudeSessionsPanel-rowTime';
-            time.textContent = this._formatRelativeTime(session.file_mtime);
-            row.appendChild(time);
+        name.textContent = this._lookupName(session);
+        // Branch icon + total conversation count - only when the project has
+        // branches. Lives inside the name span so it hugs the label text
+        // instead of being flexed to the row's right edge.
+        if (session.extra_sessions > 0) {
+            const badge = document.createElement('span');
+            badge.className = 'jp-ClaudeSessionsPanel-branchBadge';
+            const icon = document.createElement('span');
+            icon.className = 'jp-ClaudeSessionsPanel-branchBadgeIcon';
+            branchIcon.element({ container: icon });
+            badge.appendChild(icon);
+            badge.appendChild(document.createTextNode(String(session.extra_sessions + 1)));
+            name.appendChild(badge);
         }
+        row.appendChild(name);
         // No star in the Favorites section - every row there is a favorite
         // by definition; stars are an indicator only useful in Recent/All.
+        // Star sits before the time so the fixed-width time column stays the
+        // rightmost alignment anchor across all rows.
         if (session.favourite && sectionKey !== 'favourites') {
             const star = document.createElement('span');
             star.className = 'jp-ClaudeSessionsPanel-favStar';
@@ -827,6 +845,12 @@ export class ClaudeCodeSessionsWidget extends Widget {
             starFilledIcon.element({ container: star });
             row.appendChild(star);
         }
+        if (session.file_mtime) {
+            const time = document.createElement('span');
+            time.className = 'jp-ClaudeSessionsPanel-rowTime';
+            time.textContent = this._formatRelativeTime(session.file_mtime);
+            row.appendChild(time);
+        }
         row.addEventListener('click', () => {
             if (removing) {
                 return;
@@ -1043,11 +1067,21 @@ export class ClaudeCodeSessionsWidget extends Widget {
             }
         });
         this._commands.addCommand('claude-code-sessions:switch-branch-more', {
-            label: () => `More... (${this._lastBranches.length} total)`,
+            label: () => `Manage Sessions... (${this._lastBranches.length})`,
             execute: () => {
-                void this._showBranchPopup(this._lastBranches);
+                void this._showBranchPopup(this._lastBranches, this._lastBranchesCurrent);
             }
         });
+        this._commands.addCommand('claude-code-sessions:branch-session', {
+            label: 'Branch Session...',
+            icon: branchIcon,
+            execute: () => void this._branchSession(false)
+        });
+        this._commands.addCommand('claude-code-sessions:branch-session-dangerous', {
+            label: 'Branch Session (Skip Permissions)...',
+            icon: shieldIcon,
+            execute: () => void this._branchSession(true)
+        });
         this._commands.addCommand('claude-code-sessions:remove', {
             label: 'Remove from Claude',
             icon: removeIcon,
@@ -1081,7 +1115,7 @@ export class ClaudeCodeSessionsWidget extends Widget {
         // sessions/branches fetch.
         this._branchSubmenu = new Menu({ commands: this._commands });
         this._branchSubmenu.addClass('jp-ClaudeSessionsContextMenu');
-        this._branchSubmenu.title.label = 'Switch Conversation Branch';
+        this._branchSubmenu.title.label = 'Switch and Manage Sessions';
         this._contextMenu = new Menu({ commands: this._commands });
         this._contextMenu.addClass('jp-ClaudeSessionsContextMenu');
         this._rebuildContextMenu(false);
@@ -1119,6 +1153,12 @@ export class ClaudeCodeSessionsWidget extends Widget {
                 submenu: this._branchSubmenu
             });
         }
+        this._contextMenu.addItem({
+            command: 'claude-code-sessions:branch-session'
+        });
+        this._contextMenu.addItem({
+            command: 'claude-code-sessions:branch-session-dangerous'
+        });
         this._contextMenu.addItem({
             command: 'claude-code-sessions:cleanup-parallel'
         });
@@ -1133,9 +1173,12 @@ export class ClaudeCodeSessionsWidget extends Widget {
             try {
                 const data = await requestAPI(`sessions/branches?encoded_path=${encodeURIComponent(session.encoded_path)}`, this._serverSettings, { cache: 'no-store' });
                 this._lastBranches = data.branches;
+                this._lastBranchesCurrent = data.current;
                 this._branchSubmenu.clearItems();
-                // The submenu shows only the 5 most recent; the full list lives
-                // behind "More..." in a searchable popup.
+                this._branchSubmenu.title.label = `Switch and Manage Sessions (${data.branches.length})`;
+                // The submenu shows only the 5 most recent inline (fewest clicks
+                // for often-used sessions); the full list plus management lives
+                // behind the always-present "Manage Sessions..." popup.
                 for (const b of data.branches.slice(0, 5)) {
                     this._branchSubmenu.addItem({
                         command: 'claude-code-sessions:switch-branch',
@@ -1145,12 +1188,10 @@ export class ClaudeCodeSessionsWidget extends Widget {
                         }
                     });
                 }
-                if (data.branches.length > 5) {
-                    this._branchSubmenu.addItem({ type: 'separator' });
-                    this._branchSubmenu.addItem({
-                        command: 'claude-code-sessions:switch-branch-more'
-                    });
-                }
+                this._branchSubmenu.addItem({ type: 'separator' });
+                this._branchSubmenu.addItem({
+                    command: 'claude-code-sessions:switch-branch-more'
+                });
                 hasBranches = data.branches.length > 0;
             }
             catch (_a) {
@@ -1160,35 +1201,90 @@ export class ClaudeCodeSessionsWidget extends Widget {
         this._rebuildContextMenu(hasBranches);
         this._contextMenu.open(x, y);
     }
-    /** Popup with the project's full branch list - browse and filter when
-     * the list is too large for the submenu. Clicking an entry switches. */
-    _showBranchPopup(branches) {
+    /** Popup with the project's full branch list - browse, filter, switch
+     * and manage. Clicking an entry switches while nothing is selected;
+     * checkbox selection (one, many, or select-all) arms a two-step Delete
+     * button that removes the chosen sessions. The current conversation is
+     * shown first, badged and untouchable. */
+    _showBranchPopup(branches, current) {
+        // Local working copy so deletions can refresh the list in place.
+        let items = [...branches];
+        const selected = new Set();
+        let confirmArmed = false;
         const body = document.createElement('div');
         body.className = 'jp-ClaudeSessionsPanel-branchPopup';
         const search = document.createElement('input');
         search.type = 'search';
-        search.placeholder = 'Filter branches...';
+        search.placeholder = 'Filter sessions...';
         search.className = 'jp-ClaudeSessionsPanel-branchSearch';
         body.appendChild(search);
+        const selectAllBar = document.createElement('label');
+        selectAllBar.className = 'jp-ClaudeSessionsPanel-branchSelectAll';
+        const selectAll = document.createElement('input');
+        selectAll.type = 'checkbox';
+        selectAllBar.appendChild(selectAll);
+        selectAllBar.appendChild(document.createTextNode('Select all'));
+        body.appendChild(selectAllBar);
         const list = document.createElement('div');
         list.className = 'jp-ClaudeSessionsPanel-branchList';
         body.appendChild(list);
+        const footer = document.createElement('div');
+        footer.className = 'jp-ClaudeSessionsPanel-branchFooter';
+        const deleteBtn = document.createElement('button');
+        deleteBtn.className = 'jp-ClaudeSessionsPanel-branchDelete';
+        footer.appendChild(deleteBtn);
+        body.appendChild(footer);
         const bodyWidget = new Widget({ node: body });
         const dialog = new Dialog({
-            title: 'Switch Conversation Branch',
+            title: 'Switch and Manage Sessions',
             body: bodyWidget,
             buttons: [Dialog.cancelButton()]
         });
-        const render = () => {
+        const visibleMatches = () => {
             const needle = search.value.trim().toLowerCase();
-            list.replaceChildren();
-            const matches = branches.filter(b => !needle ||
+            return items.filter(b => !needle ||
                 b.label.toLowerCase().includes(needle) ||
                 b.session_id.toLowerCase().includes(needle));
+        };
+        // Any selection change disarms a pending confirm.
+        const updateControls = () => {
+            confirmArmed = false;
+            deleteBtn.disabled = selected.size === 0;
+            deleteBtn.textContent = `Delete (${selected.size})`;
+            deleteBtn.classList.remove('jp-mod-confirm');
+            const visible = visibleMatches();
+            const visibleSelected = visible.filter(b => selected.has(b.session_id)).length;
+            selectAll.checked =
+                visible.length > 0 && visibleSelected === visible.length;
+            selectAll.indeterminate =
+                visibleSelected > 0 && visibleSelected < visible.length;
+        };
+        const render = () => {
+            list.replaceChildren();
+            // The current conversation leads the list - badged, unselectable,
+            // undeletable; only the extras below it are manageable.
+            const currentRow = document.createElement('div');
+            currentRow.className = 'jp-ClaudeSessionsPanel-branchRow jp-mod-current';
+            currentRow.title = `Session id: ${current}`;
+            const currentLabel = document.createElement('span');
+            currentLabel.className = 'jp-ClaudeSessionsPanel-branchLabel';
+            const currentName = this._activeSession
+                ? this._lookupName(this._activeSession)
+                : current.slice(0, 8);
+            currentLabel.textContent = `${currentName} (${current.slice(0, 8)})`;
+            currentRow.appendChild(currentLabel);
+            const badge = document.createElement('span');
+            badge.className = 'jp-ClaudeSessionsPanel-branchCurrentBadge';
+            badge.textContent = 'current';
+            currentRow.appendChild(badge);
+            list.appendChild(currentRow);
+            const matches = visibleMatches();
             if (matches.length === 0) {
                 const empty = document.createElement('div');
                 empty.className = 'jp-ClaudeSessionsPanel-emptySection';
-                empty.textContent = 'No matching branches.';
+                empty.textContent = items.length
+                    ? 'No matching sessions.'
+                    : 'No other conversations.';
                 list.appendChild(empty);
                 return;
             }
@@ -1196,6 +1292,21 @@ export class ClaudeCodeSessionsWidget extends Widget {
                 const row = document.createElement('div');
                 row.className = 'jp-ClaudeSessionsPanel-branchRow';
                 row.title = `Session id: ${b.session_id}`;
+                const check = document.createElement('input');
+                check.type = 'checkbox';
+                check.checked = selected.has(b.session_id);
+                // The checkbox is its own click zone - ticking must not switch.
+                check.addEventListener('click', e => {
+                    e.stopPropagation();
+                    if (check.checked) {
+                        selected.add(b.session_id);
+                    }
+                    else {
+                        selected.delete(b.session_id);
+                    }
+                    updateControls();
+                });
+                row.appendChild(check);
                 const label = document.createElement('span');
                 label.className = 'jp-ClaudeSessionsPanel-branchLabel';
                 label.textContent = this._branchDisplayName(b);
@@ -1205,17 +1316,179 @@ export class ClaudeCodeSessionsWidget extends Widget {
                 time.textContent = this._formatRelativeTime(b.file_mtime);
                 row.appendChild(time);
                 row.addEventListener('click', () => {
+                    // Selection mode: while anything is ticked, row clicks toggle
+                    // selection - no accidental switch mid-selection.
+                    if (selected.size > 0) {
+                        if (selected.has(b.session_id)) {
+                            selected.delete(b.session_id);
+                        }
+                        else {
+                            selected.add(b.session_id);
+                        }
+                        check.checked = selected.has(b.session_id);
+                        updateControls();
+                        return;
+                    }
                     dialog.dispose();
                     void this._switchBranch(b.session_id);
                 });
                 list.appendChild(row);
             }
         };
-        search.addEventListener('input', render);
+        selectAll.addEventListener('change', () => {
+            // Select-all acts on the visible (filtered) rows only.
+            const visible = visibleMatches();
+            if (selectAll.checked) {
+                visible.forEach(b => selected.add(b.session_id));
+            }
+            else {
+                visible.forEach(b => selected.delete(b.session_id));
+            }
+            render();
+            updateControls();
+        });
+        deleteBtn.addEventListener('click', () => {
+            if (selected.size === 0) {
+                return;
+            }
+            if (!confirmArmed) {
+                // Two-step delete: first click arms, second click executes.
+                confirmArmed = true;
+                deleteBtn.textContent = `Confirm delete (${selected.size})`;
+                deleteBtn.classList.add('jp-mod-confirm');
+                return;
+            }
+            void this._deleteBranches([...selected]).then(deleted => {
+                if (deleted === null) {
+                    return;
+                }
+                items = items.filter(b => !selected.has(b.session_id));
+                selected.clear();
+                this._lastBranches = items;
+                render();
+                updateControls();
+            });
+        });
+        search.addEventListener('input', () => {
+            render();
+            updateControls();
+        });
         render();
+        updateControls();
         void dialog.launch();
         search.focus();
     }
+    /** Delete the given branch sessions of the active row's project.
+     * Returns the removed count, or null on failure (after notifying).
+     * Always resyncs the panel so the row's conversation count drops. */
+    async _deleteBranches(sessionIds) {
+        const session = this._activeSession;
+        if (!session) {
+            return null;
+        }
+        try {
+            const result = await requestAPI('sessions/delete-branches', this._serverSettings, {
+                method: 'POST',
+                body: JSON.stringify({
+                    encoded_path: session.encoded_path,
+                    session_ids: sessionIds
+                })
+            });
+            return result.removed_count;
+        }
+        catch (err) {
+            Notification.error(`Delete failed: ${String(err)}`, {
+                autoClose: 4000
+            });
+            return null;
+        }
+        finally {
+            await this._fetch();
+        }
+    }
+    /** Fork the active row's current conversation into a new named branch.
+     *
+     * Asks for a name, then launches a terminal running
+     * ``claude --resume <current> --fork-session --session-id <new uuid>`` -
+     * the uuid is generated here so the forked JSONL is known up front. Once
+     * claude materialises the file (polled via sessions/set-title) the chosen
+     * name is stamped as a custom-title record. The fork is the newest JSONL,
+     * so the recency resolution makes it the row's current conversation
+     * without an explicit switch.
+     */
+    async _branchSession(forceDangerous) {
+        const session = this._activeSession;
+        if (!session) {
+            return;
+        }
+        const named = await InputDialog.getText({
+            title: 'Branch Session',
+            label: 'Name for the new session',
+            placeholder: this._lookupName(session)
+        });
+        if (!named.button.accept || !named.value || !named.value.trim()) {
+            return;
+        }
+        const title = named.value.trim();
+        const forkId = UUID.uuid4();
+        const spinner = this._showLaunchSpinner();
+        try {
+            const launched = await requestAPI('launch-terminal', this._serverSettings, {
+                method: 'POST',
+                body: JSON.stringify({
+                    project_path: session.project_path,
+                    session_id: session.session_id,
+                    fork_session_id: forkId,
+                    dangerously_skip_permissions: forceDangerous || this._dangerouslySkip
+                })
+            });
+            const widget = await this._app.commands.execute('terminal:open', {
+                name: launched.terminal_name
+            });
+            if (widget === null || widget === void 0 ? void 0 : widget.id) {
+                this._terminalsByPath.set(session.project_path, widget);
+                this._wireTerminalDisposal(session.project_path, widget);
+                this._focusTerminal(widget);
+            }
+        }
+        catch (err) {
+            this._showError(err);
+            return;
+        }
+        finally {
+            spinner.dispose();
+        }
+        // Stamp the name in the background once the forked JSONL appears -
+        // claude writes it on its first record, typically within seconds.
+        void this._stampForkTitle(session.encoded_path, forkId, title);
+    }
+    /** Retry sessions/set-title until the forked JSONL exists (404 while it
+     * does not), then refresh so the row shows the named fork as current. */
+    async _stampForkTitle(encodedPath, sessionId, title) {
+        for (let attempt = 0; attempt < 30; attempt++) {
+            try {
+                await requestAPI('sessions/set-title', this._serverSettings, {
+                    method: 'POST',
+                    body: JSON.stringify({
+                        encoded_path: encodedPath,
+                        session_id: sessionId,
+                        title
+                    })
+                });
+                await this._fetch();
+                return;
+            }
+            catch (err) {
+                const notYet = err instanceof ServerConnection.ResponseError &&
+                    err.response.status === 404;
+                if (!notYet) {
+                    break;
+                }
+                await new Promise(resolve => setTimeout(resolve, 1000));
+            }
+        }
+        Notification.warning(`Branched session started, but the name "${title}" could not be applied - use /rename in the session.`, { autoClose: 6000 });
+    }
     /** Switch the active row's project to another conversation branch.
      * The backend touches the branch JSONL's mtime; a refresh then shows
      * the selected conversation as the row's current one. */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jupyterlab_claude_code_extension",
-    "version": "1.2.5",
+    "version": "1.2.9",
     "description": "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.",
     "keywords": [
         "jupyter",