Planner
plannerscompone il lavoro in un grafo di slice con le dipendenze
graph · slice · deps
v2.65.0 · Apache-2.0
Zelari-Code · Open source
Zelari-Code, l'agente che non si fida di sé stesso
Un orchestratore di coding open source: tu scegli il modello, la prova è obbligatoria. Kraken scompone il lavoro e lo delega a tentacoli specializzati, e un turno non chiude come riuscito finché la verifica non passa.
Schermata reale · v2.65.0
zelari-code@studio: ~
$ zelari-code
[ok] Kraken online · 4 tentacoli pronti
[ok] strict-done ON · worktree ON
[kraken] lead · decompone il lavoro in slice
01Il problema
Il problema del chat coding
Un singolo thread di chat non è un workflow di sviluppo, e senza verifica non sai se il lavoro è davvero finito.
Contesto che degrada
Nelle sessioni lunghe il contesto sfuma: il modello dimentica le decisioni prese due ore prima.
"Fatto" sulla parola
L'agente dichiara che funziona e nessuno esegue test o build prima di chiudere.
Scritture che si pestano
Più passaggi modificano gli stessi file nello stesso albero, senza isolamento né rollback.
Permessi a sentimento
O approvi ogni comando a mano, o lasci fare tutto: in mezzo non c'è una policy.
Poco audit
Difficile ripercorrere cosa è successo, perché un comando è stato negato o chi ha scritto cosa.
La promessa di Zelari-Code
Kraken scompone e delega, ogni writer lavora in un worktree isolato, un revisore cieco giudica dall'output reale e il gate strict-done impedisce di chiudere con verifiche aperte. Tutto finisce nello spine di sessione, riproducibile con replay.
02Funzioni
Cosa lo rende unico
Non un autocomplete, non un chat agent: un orchestratore che dimostra il lavoro invece di dichiararlo.
01
Kraken e tentacoli
Un lead che coordina e quattro ruoli: Planner, Explorer, Builder e Checker. Ogni ruolo può usare un modello diverso, anche di un altro provider. Il council a sei ruoli resta disponibile quando serve un secondo parere.
02
Worktree isolati
Ogni tentacolo che scrive lavora in un git worktree privato che parte dal tuo albero, modifiche non committate incluse. A fine lavoro fa lo squash-merge; se c'è un conflitto torna indietro senza toccare il tuo lavoro.
03
Strict-done
Il Checker è cieco: vede solo l'output reale di test, typecheck e build. Un PASS scritto a parole senza comandi eseguiti non conta; con verifiche aperte il turno non chiude come riuscito (exit 4).
04
Permessi a policy
Regole allow/ask/deny valutate prima di ogni tool, preset strict, standard e yolo, classificatore deterministico dei comandi (safe, review, destructive, blocked). Ogni diniego resta tracciato.
05
Memoria e sessioni
Session spine con replay, workspace .zelari/, compaction deterministica e sessioni riprendibili. La memoria degli esiti registra solo il lavoro che ha passato la verifica.
06
Provider-agnostico, attento ai costi
Grok, ChatGPT, Claude, Muse, GLM, MiniMax, DeepSeek, Xiaomi MiMo o qualsiasi endpoint OpenAI-compatible. Layout pensato per la prompt cache: dalla 2.65 circa 12.500 token in meno per richiesta del lead.
- Grok
- ChatGPT
- Claude
- Muse
- GLM
- MiniMax
- DeepSeek
- Xiaomi MiMo
- OpenAI-compatible
03Come funziona
Dalla richiesta al merge, con prove
Il flusso di default in mode kraken: dalla richiesta al merge, con la verifica come condizione per chiudere.
Lead
Kraken legge la richiesta, la scompone in slice e decide cosa fare da sé e cosa delegare.
Explore
Tentacoli in sola lettura mappano il codice rilevante e riportano cosa hanno trovato.
Build
I Builder scrivono in worktree git isolati, partendo dal tuo albero di lavoro attuale.
Verify
Un Checker cieco esegue test, typecheck e build: il verdetto viene solo dall'output reale.
Merge & gate
Squash-merge nel tuo albero. Con debiti di verifica aperti il turno non si chiude come riuscito.
04Architettura
Kraken e i tentacoli
Un lead che coordina e quattro ruoli specializzati, ognuno con il proprio modello e il proprio sforzo di ragionamento.
KRAKEN · lead
plan · delegate · gate
Planner
planner
Explorer
explore
Builder
general
Checker
verify
verifysquash-mergestrict-done gate
Explorer
explorelegge e mappa il codice, non scrive mai
read-only · quick/medium/deep
Builder
generalscrive in un worktree privato, poi squash-merge
.zelari/worktrees/ · merge
Checker
verifygiudica solo dall'output reale dei comandi
npm test · tsc → VERDICT
On-demand
Council on-demand
Quando il lavoro merita un secondo parere: sei ruoli in sequenza per piano, idee, mappa della conoscenza, critica e sintesi. Dalla CLI con --mode council; nel Desktop 2.65 le modalità sono Kraken e Zelari.
Caronte01
Orchestrator · Director
frame del problema e delega
mandate → specialisti
Nettuno02
Planner
piano buildable, fasi e task
createPlan · fasi × task
Gerione03
Ideator
divergenza creativa, poi top pick
journey · IA · tokens
Plutone04
Knowledge Architect
mappa concetti navigabile
knowledge-map
Minosse05
Quality Critic
espone gap e rischi, non codice prodotto
risks · scores
Lucifero06
Synthesizer · Implementer
sintesi; implementa solo se abilitato
synthesis · write/edit
05Sessione
Una run, dall'inizio alla fine
Flusso illustrativo in mode kraken, headless con gate strict-done. Output semplificato; tentacoli, worktree e gate sono quelli reali.
zelari@studio: zelari-code --headless --task "Aggiungi la paginazione a GET /tasks" --strict-doneDemo illustrativa
$ zelari-code --headless --task "Aggiungi la paginazione a GET /tasks" --strict-done
[kraken] lead · piano in 3 slice ✓
[explore] route /tasks + test esistenti · read-only ✓
[general] worktree .zelari/worktrees/t2 · 4 file ✓
[verify] npm test · tsc --noEmit → PASS ✓
[merge] squash-merge nel tree del lead ✓
[gate] strict-done · evidenze sullo spine ✓
> exit 0 · verificato, non dichiarato
06Interfacce
Un motore, sei modi per usarlo
CLI
zelari-code: scriptabile, con /update, --doctor --fix e comandi slash.
TUI
Console interattiva keyboard-first, status line configurabile, Ctrl+O per l'output completo dei tool.
Desktop
Workbench Tauri con schede, attività Kraken, MCP e SSH. Avvia la CLI come sidecar.
Headless / CI
--headless --task con output JSON, exit code 0–4 ed export delle traiettorie in formato ATIF.
Editor via ACP
zelari-code acp parla l'Agent Client Protocol: Zed, Neovim e un'estensione VS Code sperimentale.
Companion Android
Il telefono come thin client via Tailscale o LAN: approvazioni, domande e steer della run.
07Desktop · v2.65.0
Un workbench, non una chat
Un workbench, non una chat: schede per progetto, attività dei tentacoli in tempo reale, modelli e permessi a portata di clic. Stesso motore della CLI.
Schede e progetti
Le conversazioni si aprono come schede; la sidebar le raggruppa per progetto. Chat in parallelo su progetti diversi restano isolate.
Pill Tentacoli
Dal composer scegli la delega (Automatic, Prefer, Maximum, Lead only) e, per ogni ruolo, modello e sforzo di ragionamento.
Attività Kraken
Ogni tentacolo con stato, durata, modello e provider reale. Se la maggior parte dei suoi tool fallisce viene segnalato come "degraded".
Dashboard delle run
Tutte le run di tutte le conversazioni in un pannello, con progetto, prompt di partenza e stato live.
Estensioni MCP e SSH
Server MCP dal catalogo o custom, connessioni SSH con allowlist dei comandi, avvisi di sistema leggibili con la causa e cosa fare.
Companion Android
Abbini il telefono con un QR: approvi o neghi i tool, rispondi alle domande dell'agente e guidi la run mentre sei lontano dal PC.
08Download
Scarica Zelari Desktop
Shell Tauri opzionale per sessioni lunghe, attività dei tentacoli e chat in parallelo. Stesso motore della CLI.
Installer v2.65.0. L'installer non installa né aggiorna la CLI: usa npm i -g zelari-code (oppure Settings → Update CLI). Al primo avvio una guida verifica Node e CLI.
Requisiti e setup
- Node.js ≥ 20.17 e npm ≥ 10
- CLI: npm i -g zelari-code, oppure npx zelari-code@latest senza installare
- Un provider LLM: chiave API oppure login OAuth (/login grok, chatgpt, anthropic, muse)
- Git consigliato; su Windows serve Git Bash per il tool bash
- Windows x64 · macOS arm64 · Linux x64
v2.65.0 · Desktop shell · Apache-2.0
09Casi d'uso
Dove fa la differenza
Dove Zelari-Code fa la differenza rispetto a un semplice chat coding.
Feature end-to-end
Dal brief al merge: Kraken pianifica, i Builder implementano in parallelo e il Checker verifica prima di chiudere.
Review e refactor
Refactor su più file senza rischi per il tuo albero: worktree isolati e rollback se il merge fallisce.
Decisioni architetturali
Il council mette a confronto piano, alternative e rischi prima che si scriva codice.
Run non presidiate
In headless con --permissions yolo e strict-done: l'exit code dice se il lavoro è davvero verificato.
Team & handoff
Sessioni riproducibili con replay e report: intent, decisioni, dinieghi ed esiti in un unico filo.
10Confronto
Chat coding contro orchestrazione
Cosa cambia rispetto a un assistente chat generico.
| Capacità | Chat coding | Zelari-Code |
|---|---|---|
| Architettura | Chat codingsingle-agent chat | Zelari-CodeKraken + tentacoli, council on-demand |
| Verifica del done | Chat codingsulla parola | Zelari-CodeChecker cieco + strict-done |
| Isolamento delle scritture | Chat codingstesso albero | Zelari-Codegit worktree per tentacolo |
| Permessi | Chat codingtutto o niente | Zelari-Codepolicy allow/ask/deny |
| Memoria di progetto | Chat codingeffimera | Zelari-Codepersistente (.zelari/) |
| Audit | Chat codinglog sparsi | Zelari-Codesession spine + replay |
| Modelli | Chat codingspesso lock-in | Zelari-Codeuno per ruolo, qualsiasi provider |
| Interfacce | Chat codingvaria | Zelari-CodeCLI · TUI · Desktop · ACP · mobile |
11Sicurezza
Controllo e sicurezza
Kraken lavora per te, non al posto tuo senza supervisione.
Verifica prima del done
Nessun turno chiude come riuscito con verifiche aperte: il gate strict-done è attivo di default in mode kraken build.
Policy dei permessi
Regole allow/ask/deny prima di ogni tool, con deny che vince sempre. Ogni diniego finisce nello spine con la regola che l'ha causato.
Scritture isolate
Worktree git per ogni writer, snapshot del tuo lavoro non committato e rollback automatico se il merge fallisce.
Comandi classificati
Un classificatore deterministico, senza LLM, marca ogni comando come safe, review, destructive o blocked.
Sessioni riprendibili e riproducibili
Resume, replay e report di fine sessione ricostruiti dallo spine: puoi sempre ripercorrere il perché.
Open source Apache-2.0
Codice su GitHub, pacchetti su npm (zelari-code e @zelari/core). Costruito da Anathema Studio.
12FAQ
Domande frequenti
Risposte rapide prima della documentazione completa.
Supporto commerciale o integrazioni custom?
ContattiSì, Apache-2.0. Codice su GitHub (N-THEM-Studio/zelari-code), CLI su npm come zelari-code e runtime riusabile come @zelari/core. Versione attuale: v2.65.0.
Serve Node.js ≥ 20.17. Per provarlo senza installare: npx zelari-code@latest. Per l'uso quotidiano: npm install -g zelari-code, che abilita anche /update. Su Windows conviene lanciare una volta zelari-code --doctor.
Il lavoro viene scomposto e delegato a tentacoli con ruoli e permessi diversi; chi scrive lo fa in un worktree isolato e un revisore cieco verifica con comandi reali. "Fatto" significa verificato: con verifiche aperte il turno non chiude come riuscito.
Mode sceglie come si distribuisce il lavoro: kraken (default), council o zelari (missioni che proseguono finché il risultato non è dimostrato). Phase (plan o build) decide se l'agente può modificare il progetto. Sono assi indipendenti.
Sì. È una pipeline di sei ruoli (Caronte, Nettuno, Gerione, Plutone, Minosse, Lucifero) da usare quando il lavoro merita un secondo parere. Dalla CLI si attiva con --mode council; nel Desktop 2.65 le modalità disponibili sono Kraken e Zelari.
xAI Grok, ChatGPT, Anthropic Claude, Muse, GLM/Z.AI, MiniMax, DeepSeek, Xiaomi MiMo e qualsiasi endpoint OpenAI-compatible. Login OAuth con /login per Grok, ChatGPT, Anthropic e Muse. Puoi assegnare un modello diverso a ogni tentacolo.
No. CLI, TUI e headless bastano. Desktop è opzionale: avvia zelari-code --headless come sidecar e non sostituisce npm i -g zelari-code.
Sì, tramite l'Agent Client Protocol: zelari-code acp funziona con Zed, Neovim e altri client ACP. Esiste anche un'estensione VS Code, ancora sperimentale.
13Documentazione
Tutto il dettaglio, nella documentazione
Kraken e tentacoli, mode e phase, permessi, interfacce e installazione. Il dettaglio della CLI è nel repo (docs/GUIDA.md).
- TypeScript
- Node.js ≥ 20.17
- Ink + React (TUI)
- Tauri 2 + React (Desktop)
- Kraken super-agent
- Git worktrees
- Strict-done gate
- Session spine
- MCP
- ACP
- Provider-agnostic LLM
- Apache-2.0
Prossimo passo
Prova Zelari-Code dal tuo terminale
Open source Apache-2.0: lancia npx zelari-code@latest, installa da npm o scarica Desktop 2.65.0. Contattaci per supporto commerciale e integrazioni custom.
npx zelari-code@latest · Apache-2.0
