Como funciona

O chefe sync compila seu único chefe.toml nos manifests nativos dentro de .chefe/, e então o chefe install entrega cada um à ferramenta real, para que elas resolvam e construam um único ambiente compartilhado.

flowchart TB
    subgraph recipe["uma receita (chefe.toml)"]
        direction LR
        D["[deps]<br/>conda"]
        PY["[python.deps]"]
        NP["[nodejs.deps]"]
        CG["[rust.deps]"]
    end

    subgraph compiled["chefe sync gera .chefe/"]
        direction LR
        PT["pixi.toml"]
        PJ["package.json"]
    end

    subgraph solve["chefe install executa as ferramentas reais"]
        direction LR
        PIXI["pixi<br/>conda-forge + Python"]
        NPM["npm"]
        CARGO["cargo<br/>via pixi run cargo"]
    end

    ENV(["um ambiente ativado<br/>prefixo .chefe/ no PATH"]):::brand

    D --> PT
    PY --> PT
    NP --> PJ
    CG -. sem arquivo, instala no local .-> CARGO

    PT --> PIXI
    PJ --> NPM

    PIXI --> ENV
    NPM --> ENV
    CARGO --> ENV

    classDef brand fill:#eab308,stroke:#1a1a1a,stroke-width:2px,color:#1a1a1a;

• A estrutura é validada pelo schema do chefe, enquanto as especificações de pacotes continuam sendo trabalho de cada ferramenta.
• Editar o chefe.toml através do chefe add e do chefe remove preserva seus comentários e sua formatação.
• O pixi é o motor profundo para conda e Python packages, e os outros linguagens/toolchains são camadas finas e explícitas por cima.

Início rápido

chefe init                 # scaffold a chefe.toml
chefe add ripgrep          # conda is the default resolver
chefe add torch -l python
chefe add prettier -l nodejs
chefe install              # provision every language/toolchain at once
chefe tree                 # what's declared vs installed, per language/toolchain

A seguir, a referência do manifest e a referência de comandos.