Agent Runner for JupyterLab

Agent Runner for JupyterLab is a standalone JupyterLab 4 prebuilt extension with an authenticated Jupyter Server gateway and a bundled Pi coding agent. It exposes the Agent Runner Project Center and project-bound Chatrooms without requiring the VS Code extension.

The browser only talks to the same-origin Jupyter Server. The Python extension checks ~/.agent-runner/chatbox/websocket.json and reuses a healthy loopback Agent Runner backend when one already owns the shared state. Otherwise, JupyterLab starts its own single-owner backend and built-in Pi Manager. Both surfaces use the same project descriptors and JSONL Chatroom history, while their browser-facing WebSocket routes remain separate.

A fresh Jupyter-only installation creates Townhall plus a project for the Jupyter Server root directory. Pi uses the existing OpenAI Codex credentials in ~/.pi/agent/auth.json; when credentials are absent, the Chatroom displays a Sign in to Pi device-flow action. The bundled agent requires Node.js 22.19 or newer.

Development

All commands run from this directory and use uv:

uv sync --locked --all-groups
uv run jlpm install --immutable
uv run jlpm build
uv run pytest
uv run jupyter labextension develop . --overwrite
uv run jupyter server extension enable --py jupyter_agent_runner --sys-prefix
uv run jupyter lab

Enter adds a line in the Chatroom composer. Shift+Enter sends. The routing selector is additive with @agent, @manager, and @channel mentions understood by the Agent Runner backend.

Build

uv run jlpm build:prod
uv build

The wheel contains the federated frontend assets, server-extension enablement, and the bundled Pi runtime. The browser never reads ~/.agent-runner directly.