Comandos¶
O chefe espelha os verbos do pixi sobre o manifest unificado. A maioria dos comandos aceita um env opcional, que assume default por padrão.
| comando | o que faz |
|---|---|
chefe init |
cria um chefe.toml inicial no diretório atual |
chefe sync |
compila o chefe.toml em .chefe/{pixi.toml, package.json, …} |
chefe install [env] |
sincroniza e então provisiona cada ecossistema para env |
chefe update [env] |
re-resolve para as versões mais novas permitidas em todos os linguagens/toolchains |
chefe upgrade [pkg…] |
atualiza dentro dos limites atuais ou eleva as restrições dos pacotes nomeados |
chefe add <pkg…> |
adiciona pacotes ao manifest e então re-sincroniza |
chefe remove <pkg…> |
remove pacotes onde quer que estejam declarados e então re-sincroniza |
chefe tree [env] |
declarado vs instalado, cada dependência verificada em seu próprio ecossistema |
chefe run <cmd> [args…] |
executa uma task ou executável instalado dentro do ambiente |
chefe x <cmd…> |
executa um comando em um ambiente descartável, como pipx run |
chefe shell [env] |
abre um shell ativado em env |
chefe global install [name] |
instala as dependências de cada ecossistema em um ambiente global compartilhado |
chefe global add <pkg…> |
adiciona pacotes conda ao ambiente global com o nome do workspace |
chefe global remove <pkg…> |
remove pacotes do ambiente global com o nome do workspace |
chefe global list |
mostra todos os ambientes globais ou um ambiente com -e |
chefe clean |
remove o ambiente e os manifests gerados em .chefe/ |
init¶
Escreve um chefe.toml mínimo com a plataforma atual, o conda-forge e python >=3.11. Ele se recusa a sobrescrever um manifest existente.
add¶
O conda é o resolvedor padrão, e --language/-l escolhe Python ou qualquer runtime declarado em [deps]. --spec define a versão (padrão *), enquanto --env mira um ambiente nomeado.
chefe add ripgrep numpy
chefe add torch -l python --spec ">=2.6"
chefe add prettier -l nodejs
chefe add vllm -l python --env serving
As edições preservam seus comentários e sua formatação.
tree¶
Cada pacote declarado é verificado na fonte em que foi declarado. O conda é verificado no ambiente do pixi, os pacotes Node.js em .chefe/node_modules e os crates Rust no .crates.toml do ambiente. O chefe reporta cada um como ✓ ok, ≠ divergência ou ✗ ausente, com uma contagem transitiva.
run e shell¶
chefe run build
chefe run qmd query "topic" -c zettel
chefe shell # activated shell in the default env
chefe shell serving
chefe run primeiro deixa o pixi resolver tasks declaradas e depois procura executáveis comuns no PATH do ambiente gerenciado. Isso mantém scripts de ativação e variáveis de ambiente enquanto evita aliases redundantes de task.
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
Assim como o pipx run, o chefe x provisiona um ambiente efêmero para a ferramenta e a executa, sem deixar nenhum chefe.toml para trás.
global install¶
Provisiona cada fonte em um único ambiente global compartilhado, o equivalente do chefe install para ferramentas que você quer em todos os lugares. O conda passa pelo pixi global; adaptadores então usam binários desse ambiente global para fontes que precisam de uma segunda etapa, como Python, Node.js e 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