jupyterlab_nb_venv_kernels_ui_extension

Context menu extension for kernel launcher cards. Right-click on any kernel to navigate to its project directory, open a terminal, or manage the virtual environment. Intended to complement nb_venv_kernels for workspace management.

Features

Context Menu (right-click on kernel launcher card):

• Show in File Browser - Navigate to the kernel's project root
• Open Terminal at Location - Open terminal at the kernel's project directory
• Unregister Kernel - Remove kernel from registry (requires nb_venv_kernels)
• Remove Environment (dangerous) - Permanently delete local .venv environments with confirmation (requires nb_venv_kernels)

Kernel Menu (provided by nb_venv_kernels):

• Scan for Virtual Environments - Discover and register new virtual environments in your workspace

General:

• Project-aware navigation - For .venv environments, navigates to project root (one level up from .venv)
• Dynamic kernel support - Works with nb_conda_kernels and nb_venv_kernels providers
• Kernel details on hover - The card's tooltip shows kernel name, kind, executable, resource directory and environment path
• Shared display names refused - When kernels in different directories share one display name, every menu action refuses and names the colliding kernels

Requirements

• JupyterLab >= 4.0.0

Install

pip install jupyterlab-nb-venv-kernels-ui-extension

Agent Skill

.agents/skills/jupyterlab-nb-venv-kernels-ui-extension/SKILL.md tells an AI coding assistant how to manage these kernels from the shell with the nb_venv_kernels CLI. pip install puts a copy at <sys.prefix>/share/jupyter/agents/skills/jupyterlab-nb-venv-kernels-ui-extension/SKILL.md. No agent reads that directory, so link it into the agent skills directory, with the Python that runs the lab:

mkdir -p ~/.agents/skills && ln -sfn "$(python -c 'import sys; print(sys.prefix)')/share/jupyter/agents/skills/jupyterlab-nb-venv-kernels-ui-extension" ~/.agents/skills/jupyterlab-nb-venv-kernels-ui-extension

Agents that read .agents/skills also find the skill in a clone of this repository. To make it available to Claude Code everywhere, link it from the root of a clone:

mkdir -p ~/.claude/skills && ln -sfn "$PWD/.agents/skills/jupyterlab-nb-venv-kernels-ui-extension" ~/.claude/skills/jupyterlab-nb-venv-kernels-ui-extension

Uninstall

pip uninstall jupyterlab_nb_venv_kernels_ui_extension