Cos'

Axel è una potente applicazione nativa per macOS progettata per accelerare i flussi di lavoro di sviluppo fungendo da gestore di attività intelligente e centralizzato per gli agenti AI. Consente agli sviluppatori di accodare attività complesse —che vanno dalla generazione e modifica del codice all'esecuzione di test o alla chiamata di API—e di distribuirle a modelli linguistici di grandi dimensioni (LLM) specializzati come Claude, Codex e OpenCode. Fornendo un'unica interfaccia semplificata, Axel elimina l'attrito del passaggio tra strumenti multipli o della gestione manuale delle interazioni con gli agenti, assicurando che gli sviluppatori possano concentrarsi puramente sulla logica e sul risultato del loro lavoro.

Questa applicazione trasforma il modo in cui i team di sviluppo interagiscono con gli assistenti AI. Invece di prompt ad-hoc, Axel introduce un sistema di coda strutturato in cui le attività possono essere prioritarie, riordinate dinamicamente durante l'esecuzione e monitorate in tempo reale. Inoltre, Axel si integra profondamente con l'ambiente di sviluppo, supportando configurazioni specifiche del progetto tramite file AXEL.md e garantendo che le competenze (skills) dell'IA siano portatili tra diversi agenti, massimizzando la coerenza ed efficienza durante l'intero ciclo di vita dello sviluppo.

Caratteristiche Principali

• Coda di Attività Accelerata: Aggiungi attività a una coda persistente, assegna loro agenti specifici (Claude, Codex, OpenCode, Antigravity) e riordina le priorità al volo senza riavviare l'esecuzione. Le attività vengono eseguite in parallelo per la massima produttività.
• Inbox di Approvazione Centralizzata: Gli agenti richiedono il permesso per azioni sensibili come modifiche ai file, esecuzione di comandi o chiamate API. Tutte le richieste sono consolidate in un'unica inbox dove gli utenti possono approvare, negare o impostare regole di auto-approvazione granulari.
• Anteprime del Contesto Completo: Prima di approvare qualsiasi azione, gli utenti visualizzano il contesto completo, inclusi i percorsi dei file, le anteprime dettagliate delle modifiche proposte (diff) e gli argomenti dei comandi.
• Competenze e Configurazione Portatili: Definisci layout di progetto, configurazioni dei pannelli e competenze utilizzando un singolo file frontmatter YAML AXEL.md. Le competenze sono archiviate centralmente (~/.config/axel/skills) e collegate automaticamente (symlinked) alle posizioni previste per ogni agente.
• Integrazione con l'Ambiente: Si integra perfettamente con i flussi di lavoro Git creando alberi di lavoro necessari (es. axel -w feat/auth) e supporta sessioni di terminale persistenti utilizzando tmux o iTerm2.
• Monitoraggio Costi e Token: Fornisce visibilità in tempo reale sull'utilizzo delle risorse, tracciando i token di input/output e i costi stimati in USD per attività, con totali cumulativi tracciati per sessione.
• Esperienza Nativa macOS: Costruito con SwiftUI, Axel offre un'applicazione nativa nella barra dei menu con profonda integrazione del sistema operativo, inclusi collegamenti da tastiera e notifiche macOS per le approvazioni bloccate.

Come Usare Axel

Iniziare con Axel comporta la configurazione dell'ambiente e la definizione del primo flusso di lavoro del progetto:

1. Installazione e Configurazione: Scarica l'applicazione nativa per macOS. Configura i tuoi agenti AI preferiti (come l'impostazione delle chiavi API per Claude o Codex) nelle impostazioni dell'applicazione.
2. Configurazione del Progetto (AXEL.md): Per progetti strutturati, crea un file AXEL.md nella directory radice. Questo frontmatter YAML definisce il layout desiderato, la struttura dei pannelli e quali competenze dovrebbero essere disponibili per quello specifico progetto.
3. Aggiunta di Attività: Aggiungi attività direttamente alla coda tramite l'interfaccia dell'applicazione o utilizzando le scorciatoie da tastiera. Specifica quale agente dovrebbe gestire l'attività (es. usa Claude per attività di scrittura creativa e Codex per la pura generazione di codice).
4. Gestione dell'Esecuzione: Monitora la coda mentre le attività vengono eseguite in parallelo. Se un'attività richiede la modifica di file o l'esecuzione di comandi, si metterà in pausa e attenderà l'approvazione nell'Inbox.
5. Approvazione delle Azioni: Rivedi l'anteprima del diff e gli argomenti del comando nell'Inbox. Approva l'azione per consentire all'agente di procedere, oppure negala. Imposta regole di auto-approvazione per operazioni a basso rischio e di sola lettura per mantenere il flusso.
6. Persistenza del Flusso di Lavoro: Sfrutta l'integrazione con tmux/iTerm2 per garantire che anche se chiudi la sessione del terminale, i processi dell'agente e gli stati delle attività persistano, permettendoti di ricollegarti in seguito.

Casi d'Uso

1. Prototipazione Rapida di Funzionalità: Uno sviluppatore deve implementare un nuovo middleware di autenticazione. Accoda l'attività "Aggiungi validazione JWT al middleware di autenticazione". Axel avvia l'albero di lavoro git necessario, l'agente redige il codice e lo sviluppatore approva la modifica del file direttamente dalla notifica di macOS, monitorando anche il costo in token.
2. Refactoring Complesso e Test: Durante il refactoring di un modulo di grandi dimensioni, gli sviluppatori possono accodare una serie di attività dipendenti: 1) Analizza dipendenze (Claude), 2) Refactorizza il codice (Codex) e 3) Esegui l'intera suite di test (comando locale). La coda assicura che i passaggi vengano eseguiti in sequenza solo dopo che il passaggio precedente è stato approvato e completato.
3. Aggiornamenti Automatici della Documentazione: Per i progetti che richiedono una sincronizzazione frequente della documentazione, gli sviluppatori possono impostare una regola di auto-approvazione per modifiche di piccole dimensioni con limiti di token ai file di documentazione (*.md). Qualsiasi modifica dell'agente a questi file viene unita istantaneamente, a condizione che la modifica sia minore.
4. Distribuzione di Competenze Cross-Agent: Un team utilizza una competenza specifica e personalizzata per la migrazione dello schema del database. Memorizzando questa competenza nella directory centrale ~/.config/axel/skills, qualsiasi agente lanciato all'interno di una sessione gestita da Axel può accedere e utilizzare immediatamente tale competenza senza configurazione manuale.

FAQ

D: Quali modelli AI supporta attualmente Axel? A: Axel è progettato per essere agnostico rispetto agli agenti, supportando modelli popolari come Claude di Anthropic, Codex di OpenAI e modelli personalizzati come OpenCode e Antigravity. Il supporto è gestito tramite file di configurazione.

D: Axel è compatibile con la mia configurazione di terminale esistente? A: Sì. Axel si integra perfettamente sia con tmux che con iTerm2, garantendo che le tue sessioni di terminale siano persistenti. Puoi chiudere il tuo laptop o l'applicazione del terminale e riprendere il lavoro esattamente da dove gli agenti si erano interrotti.

D: Come gestisce Axel la sicurezza e le modifiche non autorizzate? A: La sicurezza è fondamentale. Per impostazione predefinita, nulla viene eseguito senza esplicita approvazione dell'utente. Ogni modifica di file o esecuzione di comando viene bloccata finché non si esamina il contesto completo (incluse le anteprime diff) nell'Inbox e si approva manualmente l'azione, a meno che non sia impostata una regola esplicita di auto-approvazione.

D: Posso monitorare il costo finanziario dell'utilizzo degli agenti AI? A: Assolutamente. Axel dispone di un monitoraggio integrato dei token e dei costi. Visualizza i token di input/output e il costo stimato in USD associato a ciascuna attività eseguita, fornendo trasparenza sulla spesa per LLM.

D: Axel è disponibile su piattaforme diverse da macOS? A: Axel è attualmente sviluppato come applicazione nativa SwiftUI specificamente per l'ecosistema Apple, incluso macOS, con potenziale integrazione per iOS e visionOS in futuro.