Ambo

English summary. Ambo is a local web app that lets you chat with Claude Code and Codex at the same time, on your own computer, using the official CLIs and your own subscriptions (no API keys by default). The two agents can also plan a goal together in a meeting, hand tasks to a team of assistants chosen for the kind of work, and, if you want, have files written in an isolated folder, one work package after the other, and then reviewed. Its face is Ambud, a small white character with a two-leaf sprout: one leaf lime like Claude, one grey like Codex. The interface and the documentation are in Italian.

Ambo, in latino: tutti e due. Il suo volto è Ambud: in testa ha un germoglio con due foglie, una lime come Claude e una grigia come Codex, e il nome viene da Ambo e da bud, germoglio in inglese. Ti saluta quando apri una chat nuova, chiede scusa quando una risposta non arriva o una partita si ferma per un errore, e festeggia sopra il cartello di fine partita se la guardi finire con l'accordo: in quel momento le due foglie si toccano.

Cos'è

Ambo è un programma che gira sul tuo PC e si usa dal browser. Ti fa chattare con Claude Code e Codex insieme, con i tuoi abbonamenti.

• Chat. Scrivi un messaggio e rispondono tutti e due, uno dopo l'altro. Il secondo legge la risposta del primo e aggiunge solo quello che manca, oppure dice che non ha niente da aggiungere.
• Allegati. Dai ai lavori immagini, PDF e file di testo dal PC: in chat e in riunione gli agenti leggono i testi e le tue descrizioni, in produzione chi costruisce trova i file nel cantiere. Le foto perdono la posizione e gli altri metadati.
• Scheda compito. Quando una cosa va fatta, un agente propone una scheda con il tasto Avvia. Dopo l'avvio diventa la carta del lavoro, con le tappe, chi lavora e, alla fine, il riepilogo scritto in chat.
• Riunione. In una partita Claude e Codex fanno da capi reparto: parlano a turno e preparano insieme il piano, finché tutti e due lo sottoscrivono. Alla fine uno scrive la sintesi e l'altro la verifica. Ottieni un documento in markdown.
• Squadra. Durante la riunione i capi possono affidare incarichi agli assistenti, scelti per il tipo di lavoro: 7 di serie (ricerca, analisi, architettura, testi, design, sviluppo, controllo qualità) e, se lo chiedi, i tuoi agenti di Claude Code. Ogni assistente ha un avatar, le sue skill, un livello da 1 a 10 con un titolo, i punti esperienza (XP) che guadagna lavorando e i badge dei traguardi raggiunti.
• Procedure. Modi di lavorare già pronti (sito web, documento, analisi, codice, su misura) che dicono quale assistente fa cosa nel piano, nella produzione e nel collaudo. Puoi aggiungere le tue.
• Produzione. La decisione diventa file in una cartella separata (il cantiere), come una catena di montaggio: gli assistenti costruiscono i pacchetti di lavoro, quelli indipendenti nello stesso momento, Codex fa il collaudo e gli eventuali passi di collaudo della procedura rivedono i file. Se il collaudo non passa, si corregge.
• Anteprime. Sul computer, accanto alla chat, una plancia con i lavori della chat e gli ultimi delle altre, con la copertina di quello che hanno prodotto. Aprendo un lavoro vedi ogni file: le pagine come su un computer o su un telefono, i documenti impaginati, il codice.
• Ufficio 3D. Un ufficio diviso in reparti, con gli omini dei capi reparto e degli assistenti: vedi chi pensa, chi cerca nelle note, chi scrive, chi lavora a un incarico. Nel magazzino la catena di montaggio segue la produzione stazione per stazione. Sul computer sta in un riquadro accanto alla plancia e si ingrandisce con un tasto.
• Voce (facoltativa). Detti i messaggi; la trascrizione può restare sul PC.

Il programma non ha una parte online, non ha account suoi e non raccoglie dati di uso. Il server ascolta solo sul tuo PC (127.0.0.1). L'unica cosa che può partire dal programma, oltre a quello che le CLI mandano ai loro servizi, è un rapporto d'errore tecnico, e solo se dici sì: vedi Rapporti d'errore.

Non ci sono screenshot in questo repository.

Requisiti

• Node.js 24 o più recente.
• Claude Code, la CLI ufficiale di Anthropic, con il login del tuo account Claude. Serve un abbonamento Claude Pro, Max o superiore.
• Codex CLI, la CLI ufficiale di OpenAI, con il login del tuo account ChatGPT. Serve un piano ChatGPT che includa Codex.
• Solo su Windows: Git for Windows (https://git-scm.com/downloads/win), che serve a Claude Code.
• Un browser recente con WebGL, per l'ufficio 3D.
• Facoltativo, per la voce: Python 3.10 o più recente.

Dettagli e costi: docs/REQUISITI-E-COSTI.md.

Installazione

I passi sono gli stessi su tutti i sistemi:

1. installa Node.js;
2. installa Claude Code e Codex CLI;
3. scarica Ambo;
4. installa le dipendenze e compila la dashboard;
5. fai il login delle due CLI (vedi Primo avvio);
6. avvia il programma.

Non usare sudo con npm install -g: se npm dà errori di permessi, sistema la cartella globale di npm (o usa nvm) invece di installare come amministratore.

Windows

Apri PowerShell (non serve come amministratore).

Se PowerShell blocca npm. Con i criteri di esecuzione di serie, PowerShell può rifiutare npm con un errore su npm.ps1 ("l'esecuzione di script è disabilitata"). Hai tre strade, scegli tu:

• usa il Prompt dei comandi (cmd) per i comandi npm;
• in PowerShell scrivi npm.cmd al posto di npm (per esempio npm.cmd ci);
• permetti gli script locali solo per il tuo utente: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned. Cambia un'impostazione di sicurezza di Windows per il tuo account: fallo solo se sai cosa comporta.

1. Node.js 24 o più recente: scarica l'installer da https://nodejs.org oppure usa winget:

   winget install OpenJS.NodeJS.LTS
   

   Chiudi e riapri PowerShell, poi controlla:

   node --version
   

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗