Configurazione di Pinky Brain

Pinky si configura con flag (CLI) e variabili d'ambiente (i tre componenti: CLI, MCP e hooks). Non c'è un file di config centrale: i default sono ragionevoli e tutto ciò che è rilevante si può impostare tramite env o flag.

Precedenza nel CLI: flag > env var > default. Es.: --db x.db prevale su PINKY_DB, che prevale sul default brain.db.

Variabili d'ambiente

Variable	Usata da	Default	Cosa fa
`PINKY_DB`	CLI · MCP · hooks	`brain.db`	Percorso dell'indice SQLite (derivato e usa e getta). Impostala uguale in tutti e tre i componenti affinché CLI e agente vedano la stessa base. `pinky init` registra l'MCP con `PINKY_DB=brain.db`, lo stesso default del CLI, così `pinky reindex` e l'agente condividono l'indice.
`PINKY_HASH_EMBED`	CLI · MCP	(non impostata)	Se presente, usa l'embedder deterministico (senza scaricare il modello ONNX). Utile offline/CI. Nel CLI equivale a `--hash-embed`.
`PINKY_SAVE_DIR`	MCP	`documentation`	Cartella dove `brain_save` scrive i file `.md` fonte di verità.
`PINKY_PROJECT`	MCP	(globale)	Se impostata, le voci salvate dall'MCP restano nello scope `project:<valore>` (filtrabili per progetto).
`PINKY_DIARY_DIR`	hooks	(stdout)	Cartella dove l'hook `stop` scrive il diary (`YYYY-MM-DD.md`). Senza di essa, la riga va su stdout.
`PINKY_LOG` / `RUST_LOG`	tutti	`warn`	Livello di logging (`error`/`warn`/`info`/`debug`/`trace`). Va sempre su stderr (non contamina lo stdout dell'MCP né l'output di dati del CLI).

Flag globali del CLI

Flag	Cosa fa
`--db <percorso>`	Indice da usare (equiv. `PINKY_DB`).
`--hash-embed`	Embedder deterministico senza modello (equiv. `PINKY_HASH_EMBED`).
`--json`	Output in JSON, per scripting. Disponibile in tutti i comandi con output su stdout. In `search`, inoltre disattiva la registrazione della telemetria (uso programmatico).
`--version`	Versione del binario (`pinky`, `pinky-mcp` e `pinky-hooks` la riportano).

Diagnostica

pinky doctor stampa la config effettiva dell'indice: versione dello schema, quantità di voci/chunk, modello con cui è stato indicizzato vs. l'embedder attivo (avvisa se non coincidono) e la versione del binario. Con --json è adatto al monitoraggio.

pinky --db brain.db doctor
pinky --db brain.db --json doctor

Autocompletamento

pinky completions zsh  > ~/.zfunc/_pinky        # zsh
pinky completions bash > /etc/bash_completion.d/pinky
pinky completions fish > ~/.config/fish/completions/pinky.fish