代理能力

共享环境控制

批准或阻止 shell 命令

记录哪个环境属于哪个项目

限制文件系统和网络访问

在 Claude、Codex 和其他客户端之间保留状态

在提示时创建虚拟环境

跟踪创建和真实最后使用元数据

运行 pip、Poetry 或 uv

显示快照之间的包级更改

停止不安全操作

将损坏的环境回滚到已知状态

工具

用途

list_venvs

所有受管虚拟环境的名称。

create_venv

{name, python_version?} → 新建虚拟环境，如果配置了 uv 则使用它。

remove_venv

{name} → 递归删除。

describe_venv

{name} → 完整快照：Python 版本、包、大小、freeze 哈希、每个 shell 的激活命令。

install_packages

`{name, packages[]

requirements_file}` → pip install，返回合并的 stdout+stderr。

run_in_venv

{name, command[]} → 在虚拟环境中执行，设置 VIRTUAL_ENV 并前置 PATH。捕获输出。

exec_ephemeral

{packages[], python_version?, command[]} → 在单次调用中创建-安装-运行-销毁。

snapshot_venv

{name, label?} → 捕获 pip freeze；启用 rollback_venv。

list_snapshots

{name} → 最新的在前。

rollback_venv

{name, snapshot_id?} → 安装快照状态，然后移除其中不存在的包。

diff_snapshots

{name, from_snapshot_id, to_snapshot_id?} → 包级差异；省略 to_snapshot_id 表示当前状态。

scan_imports

{path, venv?} → 找到的第三方导入；当传入 venv 时，报告哪些缺失。

list_registry

持久的项目、标签、创建和最后使用元数据。

set_registry_metadata

{name, project?, tags[]?, confirm?} → 更新注册表元数据。

doctor

PATH 上的 Python 版本、uv 可用性、损坏的虚拟环境。

Command

Description

create <name> [--python VER]

创建虚拟环境。当配置中 use_uv: true 时使用 uv。

list [--json]

列出虚拟环境。

remove <name>

删除虚拟环境。

rename <old> <new>

重命名并通过 python -m venv --upgrade 重新生成激活脚本。

clone <src> <dst>

以源环境的 pip freeze 为基础创建全新虚拟环境。

packages <name> [--json]

已安装的包。

install <name> <requirements>

pip install -r。

upgrade [name] [--global]

升级过期的包（按虚拟环境或全部）。

clean [name] [--global]

清除 pip 缓存和 __pycache__ 目录。

size [name] [--global] [--json]

磁盘占用。

activate <name>

打印用于 eval $(...) 的 shell 命令。

deactivate

打印 deactivate。

run <name> -- <cmd>

在不激活的情况下在虚拟环境中执行；继承标准输入输出。

exec [--with pkgs] [-r req] [--python V] [--sandbox] [--keep] -- <cmd>

临时虚拟环境运行。

describe <name>

完整 JSON 快照（见上文）。

scan <path> [--venv N] [--json]

提取第三方导入；与虚拟环境进行核对。

watch <path> --venv N

文件变更时自动安装缺失的导入。

snapshot <name> [-l LABEL]

捕获 pip-freeze 状态。

snapshots <name> [--json]

列出快照（最新的在前）。

rollback <name> [snapshot-id]

先安装快照状态，然后移除快照中不存在的包。

snapshot-diff <name> <from> [to]

比较快照差异，或将某个快照与当前状态进行比较。

export <name>

以 JSON 格式打印可移植清单（名称 + Python 版本 + freeze）。

import <manifest.json>

从清单重新创建虚拟环境。

prune [--days N] [--dry-run] [--yes] [--json]

报告过期的虚拟环境；删除前需要 --yes。

registry [name]

显示持久化的创建、使用、项目和标签元数据。

registry set <name> [--project PATH] [--tag TAGS]

更新项目关联和标签。

doctor [--json]

诊断 Python 版本、uv、损坏的虚拟环境。

`config show

path

init`

显示 / 定位 / 初始化配置。

mcp [--policy MODE] [--allow-tool NAME]

具有只读、安全或完全授权策略的 MCP 服务器。

tui

Bubble Tea TUI 浏览器。

`completion [bash

zsh

fish

powershell]`

Shell 补全脚本。