All'interno del flusso di lavoro di programmazione
Ispeziona l'esecuzione.
Decidi cosa resta.
AX Code è un harness per agenti: collega un modello agli strumenti del progetto, ai registri di sessione e ai flussi di revisione. Il valore sta in ciò che puoi ispezionare, verificare e recuperare dopo che un agente ha modificato il tuo codice.
Un bug, una modifica revisionabile
Questa guida passo passo usa un'attività esemplificativa. I comandi riportati qui sotto descrivono interfacce AX Code reali; sostituisci gli ID di sessione d'esempio con i tuoi. In questa pagina non è in esecuzione alcun modello.
01 · Connetti il tuo modello e definisci i confini +
Apri AX Code nel tuo repository e usa /connect per scegliere un runtime locale supportato, un'API cloud, una CLI di programmazione o un endpoint GPU privato. Scegli le impostazioni di sandbox e di permesso prima di concedere l'accesso a codice che non conosci. Le sessioni ordinarie non impongono automaticamente la suite di test del tuo progetto.
ax-code --sandbox read-only
02 · Ispeziona il problema, poi autorizza la modifica +
Chiedi all'agente di individuare dove viene accettato un input vuoto e di identificare i test rilevanti. Esamina i risultati, attiva l'ambito di scrittura che intendi consentire e richiedi una correzione mirata. Una competenza riutilizzabile può fornire le istruzioni di indagine o revisione del tuo team.
Individua perché viene accettato un input composto solo da spazi. Mostra il codice e i test rilevanti prima di apportare modifiche.
03 · Verifica la modifica e ispeziona l'esecuzione +
Esegui i controlli del repository e ispeziona il diff. Usa il grafo di sessione per vedere i passaggi registrati e le chiamate agli strumenti. Un fallimento di controllo registrato resta un fallimento; il messaggio di completamento dell'agente non è la prova che una patch sia corretta.
git diff
ax-code graph <session-id>
04 · Confronta i tentativi o ispeziona i punti di ripristino +
Confronta due sessioni per esaminare le differenze nell'esecuzione e nei segnali di rischio. Elenca i punti di rollback disponibili prima di scegliere un passaggio di ripristino. Il ripristino dipende dagli snapshot conservati e non può annullare effetti collaterali esterni come messaggi inviati o distribuzioni remote.
ax-code compare <session-a> <session-b>
ax-code rollback <session-id> --list
Collega la tua CLI esistente
Installa una CLI supportata e accedi, quindi usa il suo ID provider qui sotto per collegarla ad AX Code. L’adattatore riutilizza l’accesso e la sessione locali della CLI.
| CLI di programmazione | ID provider | Comando locale |
|---|
| Claude Code | claude-code | claude |
| Codex CLI | codex-cli | codex |
| Grok Build CLI | grok-build-cli | grok |
| Muse Code CLI | muse-cli | muse |
Ogni provider CLI riutilizza l'accesso proprio della CLI del fornitore. Installa prima quella CLI ed effettua l'accesso, poi collegala ad AX Code usando il suo ID provider dalla tabella:
ax-code providers login <provider-id>
Usa le competenze e i controlli del repository di AX Code per strutturare l'attività, poi revisiona la sessione registrata e il diff risultante. Le capacità e la visibilità dipendono dall'adattatore e dalla CLI; la semplice integrazione non garantisce una maggiore accuratezza nella programmazione né rende visibile ogni azione annidata.
Configurazione e requisiti dei provider CLI ↗Ottieni un secondo parere
Scegli Claude Code, Codex CLI, Muse Code CLI o Grok Build CLI come provider, poi combinale con API cloud supportate, modelli locali ed endpoint GPU privati. Usa Council per raccogliere revisioni indipendenti da più provider connessi, oppure Arena per confrontare soluzioni candidate. I membri disponibili dipendono dalle tue connessioni e dalle capacità dei modelli. Council è consultivo; sei tu a esaminare i risultati e decidere cosa mantenere.
Guida al flusso di lavoro multi-modello ↗I tuoi modelli, sulla tua infrastruttura GPU
Collega un cloud GPU privato o il tuo server GPU tramite un endpoint compatibile con OpenAI. In /connect, scegli Private GPU cloud → Custom provider, inserisci l'URL dell'endpoint e la chiave API, poi seleziona un modello rilevato. Il server deve esporre il rilevamento dei modelli e supportare le capacità necessarie per le attività di programmazione.
Guida alla connessione di un cloud GPU privato ↗WebMCP: collega il tuo agente al browser
WebMCP è una proposta di standard web che consente ai siti di esporre strumenti strutturati agli agenti. AX Code può scoprirli e chiamarli, leggere istantanee delle pagine e acquisizioni dello schermo, esaminare i messaggi della console e i metadati delle richieste e utilizzare i controlli della pagina.
Scopri WebMCP e i controlli del browser ↗Oltre il singolo tentativo
La modalità Arena implement esegue le soluzioni candidate in worktree Git isolati e le valuta rispetto ai controlli del repository. I candidati verificati si classificano davanti a quelli che non superano la verifica. Sei tu a esaminare le prove e scegliere cosa mantenere; AX Code non unisce automaticamente un vincitore.
Leggi le capacità di esecuzione e arena documentate ↗Precisione a livello di compilatore: LSP live e Code Intelligence
AX Code sostituisce le modifiche cieche al codice con un'architettura di intelligenza semantica a doppio livello:
Language Server Protocol (LSP) live
Integrazione diretta con i language server attivi per TypeScript, Rust, Go, Python e Ruby. Lo strumento lsp offre il salto alla definizione, la ricerca dei riferimenti, le gerarchie di chiamata (incomingCalls / outgoingCalls) e le diagnostiche aggregate del compilatore (diagnosticsAggregated). Quando un agente modifica il codice, i risultati del typecheck live e gli errori del compilatore vengono reiniettati direttamente nel ciclo di esecuzione per un'autocorrezione immediata.
Grafo del codice SQLite deterministico
Alimentato tramite ax-code index, il grafo persistente del codice offre un'intelligenza strutturale sull'intero repository senza consumare la finestra di contesto dell'LLM. Interroga chiamanti e chiamati, calcola l'impatto esatto del raggio d'azione prima di apportare modifiche (impact_analyze), scansiona le condizioni di race asincrone (race_scan) e individua le perdite nel ciclo di vita delle risorse (lifecycle_scan).
AX Wiki: conoscenza nativa dell'architettura del repository
I grandi codebase richiedono una base architetturale, non solo grep. AX Code include un compilatore nativo di wiki del repository (@automatosx/ax-wiki) a cui si accede tramite ax-code wiki:
Documentazione basata sui sorgenti
Compila l'architettura del repository, le responsabilità dei moduli, le convenzioni e i flussi di dati in una knowledge base Markdown ordinata dentro ax-wiki/, con collegamenti diretti a simboli sorgente verificati.
Sincronizzazione incrementale
ax-code wiki update confronta gli hash dei sorgenti con il manifesto del wiki per rigenerare solo le pagine toccate dai commit git più recenti, mantenendo la documentazione sincronizzata senza costose ricostruzioni complete.
Blocchi protetti del manutentore
Preserva la conoscenza umana con i marcatori <!-- AX-WIKI:PROTECTED:START -->. Le decisioni architetturali, le avvertenze per la produzione e gli invarianti di sicurezza sopravvivono agli aggiornamenti automatici.
Base architetturale per l'agente
Compila schede wiki compatte (.ax-code/wiki-cards.md) e inietta puntatori di conoscenza in AGENTS.md, garantendo che l'agente comprenda i confini e i vincoli dei moduli prima di proporre modifiche.
Modelli, harness e competenze
Modello
Genera risposte e decisioni sull'uso degli strumenti. I modelli Qwen e DeepSeek sono esempi. La loro velocità e qualità dipendono dal modello esatto, dal modo in cui viene erogato e dall'attività.
Harness dell'agente
Collega il modello agli strumenti e gestisce il ciclo di esecuzione. AX Code, Codex, DeepSeek Harness e Hermes Agent rientrano in questo confronto. DeepSeek Harness è un progetto separato dall'API dei modelli DeepSeek.
Competenza
Istruzioni riutilizzabili per le attività e risorse di supporto facoltative. Le competenze guidano l'agente; non sostituiscono il runtime né garantiscono output corretti. AX Code supporta le competenze di progetto tramite SKILL.md.
Confronta l'harness, non solo il modello
Valuta i confini degli strumenti, le prove di sessione, il ripristino, la personalizzazione e la verifica usando la stessa attività. Funzionalità condivise come le competenze o i modelli locali non dimostrano che uno strumento sia capace in modo esclusivo.
