Skip to main content

xtralab-logo

An opinionated JupyterLab meta-package for coding agents.

xtralab reshapes JupyterLab around terminal coding agents. It bundles a curated set of extensions, a path-first file browser, rich git diffs, an agent launcher, a Model Context Protocol server that lets agents drive the app, and a quieter set of defaults. It builds on ajlab, the agent-ready JupyterLab base.

The xtralab workspace: path-first file browser, agent launcher, a side-by-side git diff, and a running Claude Code session

The documentation covers everything in detail: installation, a tour of the features, connecting agents over MCP, agent skills, and the desktop app.

Install

pip install xtralab
jupyter lab

A standalone desktop app (DMG on macOS, AppImage on Linux) ships with every tagged release on the releases page; see the desktop app docs for the Gatekeeper notes and how it manages projects and kernels.

Highlights

The xtralab launcher

The launcher starts any agent installed on your machine, with an optional prompt and a Changes list that jumps straight into a side-by-side git diff you can edit in place. Select code in an editor, a notebook, or a diff to send a prompt about it to a new or already-running agent, or queue prompts while you read. One omnibox searches files and commands, the Terminals panel shows which agent runs where, and quieter defaults keep the workspace calm. The documentation walks through each of these.

Connecting agents to JupyterLab (MCP)

xtralab runs a Model Context Protocol server inside JupyterLab, provided by jupyter-server-mcp, so an agent can open files, run cells, and read notebooks. Register the bundled proxy from a terminal inside xtralab:

claude mcp add jupyter -- jupyter-server-mcp-proxy

The launcher surfaces the matching command for every agent you have installed, and the MCP docs page covers the details.

Contributing

See CONTRIBUTING.md for the development setup, the desktop app architecture, and the documentation sources in docs/.

License

BSD-3-Clause

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xtralab-0.12.0.tar.gz (2.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

xtralab-0.12.0-py3-none-any.whl (2.3 MB view details)

Uploaded Python 3

File details

Details for the file xtralab-0.12.0.tar.gz.

File metadata

  • Download URL: xtralab-0.12.0.tar.gz
  • Upload date:
  • Size: 2.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for xtralab-0.12.0.tar.gz
Algorithm Hash digest
SHA256 b4a903373681a2738a7e5d128cdf2634ca3e49dc8270b4fb252d5f2bb23f7765
MD5 b7f0b7ed1a179cc8a0fe17de123c78dc
BLAKE2b-256 4d78e37d728114b2cc0f828264eabea0c79ccb2f77485acaee78ac0f7dd5d698

See more details on using hashes here.

File details

Details for the file xtralab-0.12.0-py3-none-any.whl.

File metadata

  • Download URL: xtralab-0.12.0-py3-none-any.whl
  • Upload date:
  • Size: 2.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for xtralab-0.12.0-py3-none-any.whl
Algorithm Hash digest
SHA256 96d469e1ffe5bdc7ee39d2e73853bb157bac48db0e10265166f8434396789cb6
MD5 d85dbebc6921f2a5be8c5ecc122a3e33
BLAKE2b-256 3ae944439cc5b11108c0f450e1d54c37802cb6b9dbcfe671325a84d48c6f3eb9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page