Admiral

Una knowledge base aziendale che cresce automaticamente con il lavoro del team, condivisa fra persone e agenti di coding indipendentemente dall’AI utilizzata.

Admiral è una knowledge base aziendale che raccoglie automaticamente le sessioni di lavoro del team con gli agenti di coding. Conversazioni, operazioni e decisioni si consultano da un pannello web e attraverso MCP, anche cambiando computer o AI. Le integrazioni attuali sono per Claude Code, Codex e GitHub Copilot.

Si installa sul proprio server e riceve i dati dalle macchine degli sviluppatori attraverso Lookout, il programma che gestisce la raccolta e le regole di condivisione.

Sessioni

Il pannello riunisce le sessioni dei diversi strumenti, organizzate per progetto, team e sviluppatore. Ogni sessione si può aprire per leggere la conversazione, esaminare le chiamate agli strumenti e controllare modelli e consumi.

La raccolta si aggiorna mentre il team lavora e può includere anche le trascrizioni già presenti sulle macchine collegate.

Ricerca e accesso dagli agenti

La ricerca trova un testo nei prompt, nelle risposte e nei risultati degli strumenti, con le righe corrispondenti e il loro contesto. Supporta espressioni regolari, parole intere e distinzione fra maiuscole e minuscole. I risultati si possono filtrare per progetto, sviluppatore, team e periodo, oppure usare come punto di partenza per una ricerca successiva.

Gli stessi contenuti sono accessibili agli agenti attraverso MCP. Da una sessione con Codex si può, per esempio, cercare una soluzione discussa da un collega con Claude Code e leggerne i passaggi rilevanti. L'accesso segue i permessi dello sviluppatore che sta usando l'agente.

Registro di progetto

Ogni progetto ha un registro nel quale gli agenti annotano modifiche, decisioni e verifiche. Le voci riportano che cosa è stato fatto, le ragioni della scelta e il risultato, con il riferimento alla sessione quando disponibile.

Una nuova voce può sostituirne una precedente senza cancellarla. Dal pannello si consultano le decisioni attuali e la loro storia, con ricerca nel testo, filtro per componente ed esportazione in Markdown.

Convenzioni aziendali

Le convenzioni raccolgono le regole che gli agenti del team devono seguire, per tutta l'azienda o per un singolo progetto. Ogni regola può avere una motivazione e dei tag, per esempio backend o sicurezza, che permettono di consultare quelle pertinenti al lavoro in corso. Le indicazioni generali arrivano agli agenti all'avvio attraverso MCP; quelle specifiche si leggono quando servono, indipendentemente dall'AI utilizzata. Le regole si gestiscono dal pannello e gli agenti possono proporne di nuove, che diventano attive dopo l'approvazione di una persona.

Consumi

La dashboard mostra costi, sessioni, richieste, token e azioni rifiutate nel periodo selezionato. Il grafico giornaliero e le tabelle si possono raggruppare per progetto, modello, team o sviluppatore.

I dati aggregati rimandano alle singole sessioni, per collegare i consumi alle attività svolte.

Lookout

Le macchine si collegano con un comando generato dal pannello, che installa Lookout e configura gli strumenti supportati. Lookout riceve la telemetria OpenTelemetry, la conserva localmente e la inoltra al server; sincronizza anche le trascrizioni.

L'interfaccia desktop e la riga di comando permettono di controllare sessioni, connessioni e consumi. Si possono collegare più istanze Admiral e altri collector OpenTelemetry, ciascuno con una coda indipendente.

Condivisione e permessi

Le regole di Lookout stabiliscono che cosa inviare a ogni istanza, anche per singola cartella di progetto. Le sessioni private condividono soltanto costi e token. Un intervallo prima dell'invio permette di rendere privata una sessione; se il contenuto è già stato condiviso, Lookout ne richiede la rimozione dal server.

Una stessa installazione Admiral può ospitare più aziende con dati separati. I ruoli regolano l'accesso alle funzioni e ai contenuti, fino a consentire la lettura delle sole sessioni dello sviluppatore.

Installazione

Il server è un unico eseguibile Rust che comprende API, raccolta della telemetria e pannello web. Usa SQLite oppure PostgreSQL; il pannello è scritto in React e TypeScript. Anche Lookout è scritto in Rust, con un'interfaccia desktop basata su egui.