命令¶
chefe 在统一的 manifest 之上镜像了 pixi 的各个动词。大多数命令都接受一个可选的 env，默认为 default。
| 命令 | 作用 |
|---|---|
chefe init |
在当前目录生成一份起步用的 chefe.toml |
chefe sync |
把 chefe.toml 编译成 .chefe/{pixi.toml, package.json, …} |
chefe install [env] |
先 sync，再为 env 配置好每一个language/toolchain |
chefe update [env] |
跨language/toolchain重新求解到允许范围内的最新版本 |
chefe upgrade [pkg…] |
在当前约束内更新，或提升指定包的约束 |
chefe add <pkg…> |
把包加入 manifest，然后重新 sync |
chefe remove <pkg…> |
在声明它们的任意位置移除包，然后重新 sync |
chefe tree [env] |
已声明 vs 已安装，每个依赖都在它自己的language/toolchain中核对 |
chefe run <cmd> [args…] |
在环境内运行任务或已安装的可执行文件 |
chefe x <cmd…> |
在临时环境中运行一条命令，类似 pipx run |
chefe shell [env] |
打开 env 中一个已激活的 shell |
chefe global install [name] |
把每个language/toolchain的依赖安装进一个共享的全局环境 |
chefe global add <pkg…> |
向以 workspace 命名的全局环境添加 conda 包 |
chefe global remove <pkg…> |
从以 workspace 命名的全局环境移除包 |
chefe global list |
显示所有全局环境，或用 -e 显示某个环境 |
chefe clean |
移除生成的 .chefe/ 环境和 manifest |
init¶
写入一份最小的 chefe.toml，包含当前平台、conda-forge 和 python >=3.11。它不会覆盖已有的 manifest。
add¶
Conda 是默认 resolver，--language/-l 可选择 Python 或任何在 [deps] 中声明的 runtime。--spec 设定版本（默认 *），--env 则指向某个具名环境。
chefe add ripgrep numpy
chefe add torch -l python --spec ">=2.6"
chefe add prettier -l nodejs
chefe add vllm -l python --env serving
编辑会保留你的注释和格式。
tree¶
每个已声明的包都会在它被声明的那个源中核对。conda 对照 pixi 环境，Node.js 包对照 .chefe/node_modules，Rust crate 对照该环境的 .crates.toml。chefe 会把每一项报告为 ✓ 正常、≠ 漂移或 ✗ 缺失，并附上传递依赖的数量。
run 与 shell¶
chefe run build
chefe run qmd query "topic" -c zettel
chefe shell # activated shell in the default env
chefe shell serving
chefe run 会先让 pixi 解析已声明的任务，然后在托管环境的 PATH 中寻找普通可执行文件。这样既保留激活脚本和环境变量，也避免重复写任务别名。
x¶
chefe x ruff check . # run a tool in a throwaway env, no manifest needed
chefe x --with build python -m build # add extra packages with --with
类似 pipx run，chefe x 为工具配置一个临时环境并运行它，不会留下任何 chefe.toml。
global install¶
把每个源都配置进一个共享的全局环境，这是 chefe install 在「想随处可用的工具」上的对应物。Conda 走 pixi global；对于 Python、Node.js、Rust 这类需要第二步的源，适配器随后使用该全局环境里的二进制。
chefe global install # every language/toolchain's deps into a shared global env
chefe global install mytools # name the env explicitly
chefe global add ripgrep fd-find
chefe global remove fd-find
chefe global list
chefe global list -e mytools