# Orca agent orchestrator è una cazzo di figata!

> Orca, l’app gratuita e open source per far lavorare più agenti in parallelo: le funzioni, la mia regia con HAL che coordina Claude Code e Grok, i limiti.

- URL: https://stocasticparrot.ai/strumenti/orca-agent-orchestrator/
- Autore: Danilo Giudice
- Uscita: 2026-11-14

![Il personaggio, con il pappagallo sulla spalla destra, indica HAL, il robottino pixel con l’occhio rosso; da HAL partono fili verso uno sciame di piccoli agenti pixel, le mascotte arancioni di Claude Code e quelle grigie con il simbolo di Grok; in alto a destra il logo di Orca](https://stocasticparrot.ai/strumenti/orca-agent-orchestrator/img/01-apertura-regia.jpg)

Come molti di voi sto soffrendo il paradosso dell’iperproduttività: venti sessioni diverse, ognuna col suo terminale, tutte che richiedono un mio intervento e una marea di notifiche ogni ora. Qualcuno la chiama AI frying, io so solo che stavo rincoglionendo. 

Mentre scrivo, la pagina con cui seguo i miei agenti ne conta 19 su 15 progetti, fra Claude Code e Grok. Quasi tutti sono fermi: hanno finito, oppure aspettano me.

**Lo spoiler:** se arrivi in fondo saprai cosa fa Orca, come ci ho messo sopra un agente che coordina gli altri (con le regole che gli ho scritto) e quali limiti ho trovato, compresi quelli che aggiusto ancora manualmente.

## Cos’è Orca

[Orca](https://orca.dev) è un’app desktop per far lavorare più agenti in parallelo: Claude Code, Codex, Grok e altri 24 elencati per nome sul sito, più «qualsiasi altro agente da riga di comando». La fa Stably AI, una startup di San Francisco finanziata da Y Combinator. È gratuita e open source, con licenza MIT, gira su macOS, Windows e Linux. La cosa molto figa è che è praticamente completissima ma soprattutto è una scatola: posso finalmente lavorare solo dentro Orca per tutto, ha anche un suo browser interno e posso switchare tra gli agenti o i task in modo veramente comodo.

Tutto si regge sul worktree.

In pratica è una seconda cartella dello stesso progetto, su un altro ramo (la linea di modifiche su cui lavori), che condivide la storia con la prima. Se un agente rifà la home del sito e un altro corregge il modulo d’iscrizione, ognuno lavora nella sua cartella e non tocca i file dell’altro; alla fine unisci i due rami. Orca dà a ogni compito una scheda, e a ogni scheda [il suo worktree](https://orca.dev/docs/model/worktrees).

**Le funzioni, una per una**

- **Schede e worktree.** Ogni compito sta in una scheda con il suo worktree, e le schede si raggruppano per progetto.
- **Agenti in chat o in terminale.** Avvii un agente in una scheda nuova o in una esistente, con un prompt, un modello e uno sforzo di partenza.
- **La riga di comando.** Orca ha un comando, `orca`, che fa da terminale quello che fai con il mouse: elenca le schede, legge quello che mostra il terminale di un agente, ci scrive dentro, apre il browser. È la parte che uso di più, perché la possono usare anche gli agenti.
- **L’orchestrazione.** Un agente coordinatore apre un *run* (uno spazio di lavoro con la sua casella di posta), crea dei compiti e avvia dei *worker*, cioè altri agenti sorvegliati. Un worker che ha un dubbio lo manda al coordinatore con `ask` e si ferma; il coordinatore risponde con `reply`; a lavoro finito il worker manda `worker_done`, anche se ha fallito. I *decision gate* bloccano un compito finché qualcuno non risponde a una domanda. [La documentazione](https://orca.dev/docs/cli/orchestration) la segna come sperimentale.
- **Un browser per scheda,** con la [Design Mode](https://orca.dev/docs/browser/design-mode): clicchi un elemento della pagina e Orca manda all’agente il suo HTML, il CSS e un ritaglio dello schermo.
- **La revisione delle modifiche** riga per riga: i tuoi commenti tornano all’agente in un solo prompt.
- **Automazioni programmate, app per il telefono e server remoti,** gli ultimi due ancora in beta.

Io uso ogni giorno le prime quattro, e il browser per guardare le immagini che producono gli agenti. L’app mobile è clamorosa: mi permette di avere il terminale FULL, con tutte le stesse feature di Orca, ma dal mio iPhone.

Una nota sulla privacy. Orca raccoglie dati d’uso pseudonimi (versione, sistema operativo, tipo di agente, conteggi dei token) e, [secondo la sua documentazione](https://orca.dev/docs/telemetry), ne esclude file, prompt, risposte degli agenti e output dei terminali. Si spegne da Impostazioni → Privacy o con `DO_NOT_TRACK=1`.

## Come lo uso: una regia sopra Orca

Orca mi mostra le schede, una per una. Con quindici progetti aperti (un’app, un paio di siti, video, social e questo brand) mi serviva vedere in un colpo d’occhio chi lavora, chi aspetta me e chi sta per riempire il contesto. Così l’11 novembre ho costruito una regia, tutta in locale. Vediamola pezzo per pezzo.

**Il Motore e la pagina**

Il Motore è uno script che gira in un terminale di Orca. Ogni 3 secondi chiede a Orca schede e terminali, legge i file in cui Claude Code tiene sessioni, lavori in background e sub-agenti, e scrive tutto in un file di stato. Da quel file nasce una pagina, aperta nel browser di Orca: un riquadro per progetto e, per ogni agente, lo stato (al lavoro, aspetta te, finito, errore, fermo), il modello, quanto contesto ha usato e quali sub-agenti ha in corso. Ha due viste, una mappa e un «ufficio», e da lì posso scrivere direttamente a un agente.

![La vista Mappa della regia: a sinistra tre agenti, HAL, Zen e una sessione di Stocastic Parrot, ognuno con i token di contesto, il modello e il timer della cache; al centro le cartelle che stanno toccando; a destra i progetti Regia, Etna Now e Stocastic Parrot, collegati da linee colorate](https://stocasticparrot.ai/strumenti/orca-agent-orchestrator/img/regia-mappa.jpg "La vista Mappa: chi lavora, su quali cartelle e per quale progetto")

![La vista Ufficio della regia: in alto HAL e Sam con le loro chat; sotto, una stanza per ogni gruppo di progetti; a destra la sala di HAL, il bancone con un agente che aspetta e la zona relax con gli agenti fermi sui divani](https://stocasticparrot.ai/strumenti/orca-agent-orchestrator/img/regia-ufficio.jpg "La vista Ufficio: una stanza per gruppo di progetti, il bancone di chi aspetta me e gli agenti fermi in relax")

**HAL, l’orchestratore**

HAL è un Claude Code in un altro terminale della regia. Ha un CLAUDE.md di una pagina che gli dice come leggere il file di stato e come parlare agli altri: prima legge quello che mostra lo schermo dell’agente con `orca terminal read`, poi gli scrive con `orca terminal send`. Io parlo con HAL, e HAL passa le mie indicazioni agli agenti, uno alla volta, citando sempre le mie parole tra virgolette.

Le regole che contano sono poche: niente push, merge, deploy o cancellazioni senza un mio sì che nomini la cosa, ogni volta. Nessuna risposta al posto mio alle richieste di permesso degli altri agenti. Nessun messaggio uguale mandato a più agenti insieme.

**Sam, il devops**

Nella stessa scheda gira Sam, un agente Grok che fa da devops a HAL: avvia server, lancia build e test, legge i log. 

**I worker, con ask e reply**

Per i lavori lunghi, con dei passaggi da approvare, uso l’orchestrazione. Un agente che monta un video, per esempio, gira come worker: quando ha pronte delle clip le manda a HAL con `ask` e chiude il suo turno. HAL le guarda e risponde con `reply`, oppure gira la domanda a me. Mentre aspetta, il worker non consuma token, e Orca lo risveglia quando arriva la risposta.

**Handoff e /clear tra il 60 e l’80 %**

Ogni sessione ha una finestra di contesto: quanti token il modello rilegge a ogni risposta. Quando si riempie, Claude Code la riassume da solo e perde dettagli che non scegli tu (ne ho scritto in [«L’auto-compaction è una cagata pazzesca»](https://stocasticparrot.ai/spiegoni/auto-compaction/)).

La cosa che mi ha davvero svoltato è stata questa: HAL tiene d’occhio il contesto di ogni agente. Tra il 60 e l’80 % aspetta un momento tranquillo (agente fermo, nessuna domanda in sospeso, nessun sub-agente al lavoro, nessun deploy a metà), gli fa scrivere un handoff, manda `/clear` e gli fa ricaricare il file. L’handoff è un file di testo con il compito, le mie decisioni con le mie parole, lo stato, i file utili e i prossimi passi: è quello che l’agente rilegge dopo il `/clear` per riprendere da dove era.

**Sempre in auto mode**

Tutti gli agenti girano in [auto mode](https://code.claude.com/docs/en/permission-modes), mai con i permessi scavalcati. In auto mode letture e modifiche nella cartella di lavoro passano da sole; ogni altra azione va a un classificatore, un modello separato che la lascia passare o la blocca ([Anthropic spiega come funziona](https://www.anthropic.com/engineering/claude-code-auto-mode)).

Nella mia installazione Orca lanciava Claude Code con `--dangerously-skip-permissions`, cioè senza nessun controllo. Nelle impostazioni di Claude Code ho spento quella modalità (`"disableBypassPermissionsMode": "disable"`), e da allora le sessioni partono comunque in auto mode. Se un agente finisce in un’altra modalità, HAL gli manda shift+tab finché la riga di stato non torna su «auto mode on».

**I riepiloghi**

Ogni mezz’ora, ai minuti 17 e 47, HAL mi manda un riepilogo: chi lavora, chi aspetta me, chi ha rinfrescato. Sono cron di Claude Code, cioè promemoria programmati dentro la sessione, e sopravvivono al `/clear`: prima di crearne uno HAL controlla che non ci sia già, per non averne due. Ma sul telefono mi arriva una notifica solo per le cose che richiedono me: un login, un pagamento, una conferma.

## I limiti che ho incontrato

- **Il classificatore blocca l’orchestratore.** Quando HAL assegna a un agente un compito che non nasce da una mia richiesta, il classificatore lo blocca come «comunicazione non autorizzata», anche dentro una delega che gli ho dato io. Blocca anche i deploy chiesti con un «tutto sì» generico, e quelli che HAL ordina a un altro agente. In quei casi HAL mi prepara la frase da copiare o il comando da lanciare io, e il passaggio a mano resta, ma sempre nella sua sessione; francamente non so se questa possa essere considerata una cosa negativa, è comunque una protezione in più.
- **Gli identificativi dei terminali cambiano.** Per scrivere a un agente serve l’identificativo del suo terminale in Orca, e l’ho visto cambiare più volte. HAL li rilegge dal file di stato ogni volta, e qualche agente resta «orfano»: lavora, ma la regia non trova più il suo terminale. Un ID per agente risolve il problema, lo sto implementando.
- **Una parte della configurazione passa da comandi interni.** La riga di comando di Orca non ha comandi per creare o rinominare i gruppi di progetti: li ho fatti con chiamate interne dell’app, che vanno ricontrollate a ogni aggiornamento.

## Se vuoi provarlo

1. Scarica Orca da [orca.dev](https://orca.dev) e registra il comando `orca` da Impostazioni → General → Orca CLI.
2. In Impostazioni → Agents scegli i permessi Auto per le nuove sessioni. Secondo [la documentazione](https://orca.dev/docs/settings) Auto vale per Claude, Agent Teams e Codex; per gli altri agenti scegli Manual. Poi, nelle impostazioni di Claude Code, spegni la modalità bypass, così nessuna sessione parte senza controlli.
3. Un gruppo per progetto, una scheda per linea di lavoro. Io tengo in Orca solo le schede su cui si lavora: quelle ferme le tolgo, i file restano sul disco.
4. Se non vuoi la telemetria, spegnila da Impostazioni → Privacy.
5. Prima di aprire il quarto agente, scrivi il CLAUDE.md dell’orchestratore: come legge lo stato, come scrive agli altri (prima guarda lo schermo), cosa non può fare senza il tuo sì e quando fa l’handoff.