agensic v0.3.0

Sappi cosa è stato eseguito, dove, quando e da chi

Il livello di osservabilità mancante per i flussi di lavoro da terminale potenziati dall'IA

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.

---

📋 Indice dei Contenuti

1. Supporto delle Piattaforme
2. Installazione
3. Avvio Rapido
4. Agensic Provenance
   • Funzionalità
   • Etichette Supportate
5. Agensic Sessions
   • Funzionalità
   • Agenti Supportati
6. Agensic Autocomplete
   • Funzionalità
   • Provider Supportati
7. Comandi Disponibili
8. Sicurezza e Privacy
9. Creatore del Progetto
10. Supporto
11. Licenza

---

💻 Supporto delle Piattaforme

Agensic è progettato per integrarsi profondamente con il tuo ambiente shell.

• macOS (Zsh) — pienamente supportato ✅

• Linux (Bash) — pienamente supportato ✅

---

🚀 Installazione

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

⚡ Avvio Rapido

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!

🤖 Tracciamento Automatico Continuo degli Agenti

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 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.

✨ Funzionalità

🔍 Esploratore di Provenienza a Schermo Intero

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à.

🛡️ Provenienza Crittografica dei Comandi e Firma

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.

🏷️ Etichette di Attribuzione Strutturate

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.

🔖 Etichette Supportate

Agensic supporta attualmente le seguenti etichette di provenienza:

• AI_EXECUTED per i comandi eseguiti direttamente da un agente IA con prova firmata
• HUMAN_TYPED per i comandi digitati manualmente da un umano nella shell
• AI_SUGGESTED_HUMAN_RAN per i comandi suggeriti da una chiamata LLM IA esterna e poi eseguiti da un umano
• AG_SUGGESTED_HUMAN_RAN per i comandi suggeriti da Agensic e poi eseguiti da un umano
• INVALID_PROOF per i comandi arrivati con metadati di prova che non hanno superato la validazione
• UNKNOWN per i comandi in cui le prove disponibili sono insufficienti per assegnare un'etichetta di attribuzione più forte

---

🕵️‍♂️ Agensic Sessions

Agensic 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.

✨ Funzionalità

▶️ Sessioni Riproducibili

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.

⏪ Time Travel