jupyterlab_codex_extension

Session management for the OpenAI Codex CLI in JupyterLab. Start, resume, fork, switch, and clean up Codex CLI sessions from a side panel - one click lands you in the right terminal with Codex already running, no duplicate tabs, no session-id hunting. The Codex counterpart of jupyterlab_claude_code_extension, with identical functionality wherever the Codex CLI makes it possible.

The extension runs the genuine, unmodified Codex CLI in JupyterLab terminals - every Codex release works the day it lands. The extension owns the JupyterLab side: launching, finding, reusing, and managing sessions.

Features

• Side panel with Favorites, Recent, and All projects, each scrolling independently
• One-click resume - click a row to jump back into that session; a terminal already running that conversation is reused, never duplicated
• Live activity indicator - see which projects have a Codex process running right now, with last-activity times on every row
• Session switcher - list a project's parallel conversations, pick one and the next click resumes exactly that one
• Branch session - fork the current conversation into a new one in its own terminal
• Clean up parallel sessions - remove a project's extra conversations, keeping only the current one; honours JupyterLab's trash setting, archiving conversations when it is on and deleting them permanently when it is off
• Search - fuzzy filter across projects, with presentation modes (session name or relative path)
• Approval bypass - opt-in and off by default: a setting and a matching menu entry launch Codex with --dangerously-bypass-approvals-and-sandbox, skipping every approval prompt and the sandbox
• Auto-disabled when the Codex CLI is not installed

Requirements

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

Install

To install the extension, execute:

pip install jupyterlab_codex_extension

Developers build and install via the project Makefile:

make install

[!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.

[!NOTE] Codex mints its own session ids, so a new or forked conversation is identified after launch rather than before it. Everything the Codex CLI cannot express is recorded as a deviation in docs/acc-crit-jupyterlab-codex-extension.md.

Uninstall

To remove the extension, execute:

pip uninstall jupyterlab_codex_extension