alex188dot/agensicAnalisi forense crittografica del terminale e replay delle sessioni per agenti AI. Traccia, firma e verifica ogni comando con etichette di provenienza, sessioni riproducibili e viaggio nel tempo tramite Git. Privacy-first con archiviazione locale SQLite e redazione dei segreti.
Signed Provenance
Tracked Sessions
Git Time Travel
Replayable Sessions
IDE style Tab Autocomplete
Agensic potenzia il tuo flusso di lavoro da terminale per l'era dell'IA. È progettato per gli sviluppatori che vogliono l'incremento di produttività degli agenti IA direttamente nella propria shell, ma non vogliono rinunciare a auditabilità, controllo e privacy.
Mentre gli agenti IA assumono sempre più il controllo della riga di comando ed eseguono attività in autonomia, la visibilità e il controllo diventano fondamentali. Agensic tratta i comandi di terminale come cittadini di prima classe e fornisce un framework robusto per tracciarli, ispezionarli e gestirli.
Invece di appiattire tutta l'attività del terminale in un'unica ambigua «cronologia della shell», Agensic agisce come un osservatore forense e un co-pilota intelligente. Traccia senza soluzione di continuità le sessioni di coding interattive con l'IA, firma crittograficamente i comandi eseguiti dagli agenti e fornisce un autocompletamento con Tab in stile IDE, velocissimo e basato sulla cronologia.
Agensic è progettato per integrarsi profondamente con il tuo ambiente shell.
macOS (Zsh) — pienamente supportato ✅
Linux (Bash) — pienamente supportato ✅
Il percorso più rapido è l'installer gestito a una riga:
curl -fsSL https://raw.githubusercontent.com/Alex188dot/agensic/main/bootstrap.sh | bash
Se preferisci clonare manualmente:
git clone https://github.com/Alex188dot/agensic.git
cd agensic
bash ./install.sh
Se hai già uv, l'installer lo userà automaticamente per un setup più rapido.
Al primo avvio, Agensic ti chiederà di scegliere il tuo provider LLM preferito e di configurare le tue chiavi API per l'autocompletamento dei comandi.
In alternativa, puoi configurare il tuo provider LLM e le chiavi API eseguendo:
agensic setup
Dopo il setup, apri un nuovo terminale e Agensic inizierà automaticamente a tracciare la tua attività nel terminale e fornirà suggerimenti di autocompletamento mentre digiti!
Inizia a lavorare come faresti normalmente, ad esempio usando il tuo assistente di coding IA preferito, come Claude Code, Codex CLI, ecc.:
claude
oppure
codex
Consulta la sezione Agenti Supportati per un elenco completo di tutti gli agenti supportati. Se il tuo agente non è nell'elenco, puoi aggiungerlo eseguendo agensic --add_agent "executable" e poi usarlo normalmente così Agensic potrà tracciarlo.
Al termine, puoi usare Agensic per ispezionare la cronologia delle sessioni:
agensic sessions
oppure visualizzare la provenienza forense:
agensic provenance
Agensic ti fornisce una trascrizione forense per ogni comando. Classifica ciò che è accaduto, registra metadati ricchi e mette in evidenza una chiara traccia di audit, così puoi capire se un comando è stato digitato manualmente, accettato da un suggerimento o eseguito direttamente da un agente.
Devi rispondere alla domanda: «Cosa è stato eseguito esattamente qui e chi lo ha attivato?» Esegui agensic provenance per aprire il visualizzatore di provenienza a schermo intero. Filtra per etichetta, agente, provider o intervallo di tempo, ispeziona l'esatta traccia dei comandi ed esporta la visualizzazione corrente in JSON o CSV quando ti serve una registrazione duratura per il debug, la revisione degli incidenti o la conformità.
Smetti di chiederti se a rompere la build sia stato un umano o un'IA. Agensic cattura metadati ricchi per ogni comando e usa la firma locale Ed25519 per contrassegnare le esecuzioni effettuate dagli agenti con un'inequivocabile etichetta AI_EXECUTED. Ottieni una timeline chiara e auditabile che separa le sequenze di tasti umane dai suggerimenti IA e dalle esecuzioni automatizzate.
Agensic non riduce la cronologia del terminale a un semplice elenco di stringhe. Ogni comando tracciato viene classificato in un'etichetta di provenienza, offrendoti un modo coerente per filtrare le esecuzioni, investigare il comportamento e capire come un comando è arrivato nella tua shell.
Agensic supporta attualmente le seguenti etichette di provenienza:
AI_EXECUTED per i comandi eseguiti direttamente da un agente IA con prova firmataHUMAN_TYPED per i comandi digitati manualmente da un umano nella shellAI_SUGGESTED_HUMAN_RAN per i comandi suggeriti da una chiamata LLM IA esterna e poi eseguiti da un umanoAG_SUGGESTED_HUMAN_RAN per i comandi suggeriti da Agensic e poi eseguiti da un umanoINVALID_PROOF per i comandi arrivati con metadati di prova che non hanno superato la validazioneUNKNOWN per i comandi in cui le prove disponibili sono insufficienti per assegnare un'etichetta di attribuzione più forteAgensic registra le sessioni interattive degli agenti, offrendoti una prova inconfutabile di ciò che è accaduto e la possibilità di manipolare in sicurezza lo stato del repository, grazie alla funzionalità Time Travel.
Devi verificare la sessione di stanotte per capire cosa è successo? Esegui agensic sessions e seleziona la sessione da riprodurre. La nostra TUI a schermo intero, velocissima, ti permette di sfogliare all'istante le timeline, ispezionare i payload e riprodurre la sessione. Quando devi condividere prove per una revisione degli incidenti, esporta il dataset esatto in JSON o CSV con un solo tasto.
Ti sei mai chiesto: «Com'era esattamente il mio repository prima che l'agente facesse quel commit distruttivo?» Time Travel ti permette di riportare il tuo repository allo stato Git esatto catturato in uno specifico checkpoint di sessione. Agensic ripristina in sicurezza i file non tracciati e modificati in un nuovo ramo, assicurandoti di non distruggere mai accidentalmente il tuo albero di lavoro attivo mentre indaghi.
I tuoi dati restano tuoi. Agensic usa un backend di stato SQLite robusto con un journal di eventi append-only e snapshot automatici. Questo significa che la tua cronologia forense sopravvive a crash inaspettati del terminale, riavvii di sistema e uso locale prolungato, senza corrompersi.
Agensic offre supporto per un insieme di agenti integrati preconfigurati che possono essere tracciati:
Agenti personalizzati: inserisci qualsiasi eseguibile di agente in agensic setup e funzionerà immediatamente senza alcuna configurazione
Agensic reinventa i suggerimenti del terminale. Un autocompletamento con Tab contestuale, semantico, sempre veloce e in stile IDE, davvero soddisfacente.
Di' addio al lag di digitazione. Mentre scrivi, Agensic interroga un archivio della tua cronologia reale dei comandi. I suggerimenti appaiono all'istante come testo fantasma e puoi accettarli facilmente con Tab. Poiché impara dai tuoi schemi e si basa su ciò che fai davvero, i suggerimenti sono molto accurati e consapevoli del repository.
Gli umani commettono errori, Agensic li corregge. Se digiti dokcer, Agensic suggerisce all'istante Did you mean: docker. Non ricordi la sintassi esatta? Il riordinamento semantico recupera la tua intenzione, trovando il comando giusto anche se il tuo prefisso non corrisponde perfettamente: se digiti docker records otterrai Did you mean: docker logs (a condizione che tu abbia eseguito docker logs in passato)
L'IA è un potente fallback, non una tassa su ogni tasto premuto. Agensic applica budget LLM per riga per prevenire lo spam di prompt. Quando la cronologia locale non basta, viene attivato automaticamente il fallback LLM. In alternativa, puoi sempre premere Ctrl+Space per ottenere manualmente un suggerimento intelligente dal tuo LLM locale o ospitato preferito.
Dimentica la sintassi esatta, descrivi semplicemente ciò che vuoi. Digita ad esempio: # how can I find all files larger than 10MB in this folder?. Agensic genera 3 comandi shell pronti da copiare e inserisce l'opzione più probabile direttamente nella tua prossima riga. Ti servono indicazioni invece dei comandi? Usa la modalità assistente per ottenere risposte passo passo direttamente nel terminale: ## How do I install Node on macOS?. Vuoi capire un comando prima di eseguirlo? Usa: agensic --explain "your command here"
Agensic rispetta il tuo terminale. Lascia Tab al suo posto quando completi percorsi di file o script, così il completamento nativo della shell continua a prevalere dove è migliore. Ancora più importante, i comandi distruttivi (come rm -rf, mkfs o dd) sono rigorosamente esclusi dai pool di suggerimenti, così non eseguirai mai accidentalmente un disastro.
Agensic si adatta al tuo stack, sia che tu esegua i modelli localmente sia che usi endpoint ospitati.
La tabella seguente elenca tutti i comandi CLI attualmente disponibili in Agensic.
Agensic opera secondo il principio del minimo privilegio e della massima privacy:
Alessio Leodori
Trovi Agensic utile? Metti una stella ⭐️ al repository e dillo a un amico! Questo ci aiuterà a crescere 🌱
Agensic è open-source e distribuito sotto la Apache-2.0 License.
| Command | What it does |
|---|
agensic --help | Mostra la guida principale della CLI e tutti i comandi standard rivolti all'utente |
agensic --version | Mostra la versione di Agensic installata ed esce |
agensic update | Scarica e installa l'ultima release GitHub pubblicata di Agensic |
agensic setup | Apre il flusso di setup interattivo per Agensic Sessions e Autocomplete |
agensic enable-startup | Configura Agensic per avviarsi automaticamente all'accesso o all'avvio del sistema |
agensic first-run | Esegue il flusso di onboarding della prima installazione |
agensic start | Avvia manualmente il daemon in background di Agensic |
agensic stop | Ferma il daemon di Agensic |
agensic logs | Segue l'output dei log del daemon in tempo reale |
agensic test | Invia una richiesta di autocompletamento di test al daemon per verificare la connettività |
agensic provenance | Apre la vista della cronologia della provenienza dei comandi. Supporta filtri come --limit, --label e --contains |
agensic sessions | Apre il browser delle sessioni tracciate. Usa --text per l'output in testo semplice |