agensic v0.3.0

Sachez ce qui a été exécuté, où, quand et par qui

La couche d'observabilité manquante pour les workflows de terminal pilotés par l'IA

Signed Provenance Tracked Sessions Git Time Travel Replayable Sessions IDE style Tab Autocomplete

Agensic améliore votre flux de travail terminal existant pour l'ère de l'IA. Il est conçu pour les développeurs qui souhaitent le gain de productivité des agents IA directement dans leur shell, mais refusent de faire des compromis sur l'auditabilité, le contrôle et la confidentialité.

Alors que les agents IA prennent de plus en plus le contrôle de la ligne de commande et exécutent des tâches de manière autonome, la visibilité et le contrôle deviennent cruciaux. Agensic traite les commandes terminal comme des citoyens de première classe et fournit un cadre robuste pour les suivre, les inspecter et les gérer.

Au lieu d'aplatir toute l'activité du terminal en un seul « historique du shell » ambigu, Agensic agit comme un observateur forensique et un copilote intelligent. Il suit de manière transparente les sessions de codage interactives avec l'IA, signe cryptographiquement les commandes exécutées par les agents et fournit une autocomplétion Tab ultra-rapide, inspirée des IDE et basée sur l'historique.

📋 Table des matières

1. Support de plateforme
2. Installation
3. Démarrage rapide
4. Provenance Agensic
   • Fonctionnalités
   • Étiquettes prises en charge
5. Sessions Agensic
   • Fonctionnalités
   • Agents pris en charge
6. Autocomplétion Agensic
   • Fonctionnalités
   • Fournisseurs pris en charge
7. Commandes disponibles
8. Sécurité et confidentialité
9. Créateur du projet
10. Soutien
11. Licence

💻 Support de plateforme

Agensic est conçu pour s'intégrer profondément à votre environnement shell.

• macOS (Zsh) — entièrement pris en charge ✅

• Linux (Bash) — entièrement pris en charge ✅

🚀 Installation

Le moyen le plus rapide est l'installateur géré en une ligne :

curl -fsSL https://raw.githubusercontent.com/Alex188dot/agensic/main/bootstrap.sh | bash

Si vous préférez cloner manuellement :

git clone https://github.com/Alex188dot/agensic.git
cd agensic
bash ./install.sh

Si vous avez déjà uv, l'installateur l'utilisera automatiquement pour une configuration plus rapide.

Au premier lancement, Agensic vous demandera de choisir votre fournisseur LLM préféré et de configurer vos clés API pour l'autocomplétion des commandes.

Alternativement, vous pouvez configurer votre fournisseur LLM et vos clés API en exécutant :

agensic setup

⚡ Démarrage rapide

Après la configuration, ouvrez un nouveau terminal et Agensic commencera automatiquement à suivre votre activité terminal et fournira des suggestions d'autocomplétion pendant que vous tapez !

🤖 Suivi automatique transparent des agents

Commencez à travailler comme vous le feriez normalement, par exemple en utilisant votre assistant de codage IA préféré, comme Claude Code, Codex CLI, etc. :

claude

ou

codex

Consultez la section Agents pris en charge pour une liste complète de tous les agents pris en charge. Si votre agent n'est pas dans la liste, vous pouvez l'ajouter en exécutant agensic --add_agent "executable" puis l'utiliser normalement pour qu'Agensic puisse le suivre.

Une fois terminé, vous pouvez utiliser Agensic pour inspecter l'historique des sessions :

agensic sessions

ou afficher la provenance forensique :

agensic provenance

🧾 Provenance Agensic

Agensic vous donne une transcription forensique pour chaque commande. Il classifie ce qui s'est passé, enregistre des métadonnées riches et dévoile une piste d'audit claire afin que vous puissiez déterminer si une commande a été tapée manuellement, acceptée à partir d'une suggestion ou exécutée directement par un agent.

✨ Fonctionnalités

🔍 Explorateur de provenance en plein écran

Besoin de répondre à la question : « Qu'est-ce qui a exactement été exécuté ici et qui l'a déclenché ? » Exécutez agensic provenance pour ouvrir le visualiseur de provenance en plein écran. Filtrez par étiquette, agent, fournisseur ou fenêtre de temps, inspectez la trace de commande exacte et exportez la vue actuelle en JSON ou CSV lorsque vous avez besoin d'un enregistrement durable pour le débogage, la revue d'incident ou la conformité.

🛡️ Provenance cryptographique et signature des commandes

Arrêtez de vous demander si un humain ou une IA a cassé la build. Agensic capture des métadonnées riches pour chaque commande et utilise la signature locale Ed25519 pour étiqueter les exécutions par agent avec une étiquette AI_EXECUTED indéniable. Vous obtenez une chronologie claire et vérifiable séparant les frappes humaines des suggestions IA et des exécutions automatiques.

🏷️ Étiquettes d'attribution structurées

Agensic ne réduit pas l'historique du terminal à une simple liste de chaînes. Chaque commande suivie est classifiée avec une étiquette de provenance, vous offrant un moyen cohérent de filtrer les exécutions, d'enquêter sur le comportement et de comprendre comment une commande est entrée dans votre shell.

🔖 Étiquettes prises en charge

Agensic prend actuellement en charge les étiquettes de provenance suivantes :

• AI_EXECUTED pour les commandes exécutées directement par un agent IA avec preuve signée
• HUMAN_TYPED pour les commandes tapées manuellement par un humain dans le shell
• AI_SUGGESTED_HUMAN_RAN pour les commandes suggérées par un appel LLM IA externe puis exécutées par un humain
• AG_SUGGESTED_HUMAN_RAN pour les commandes suggérées par Agensic puis exécutées par un humain
• INVALID_PROOF pour les commandes arrivées avec des métadonnées de preuve ayant échoué à la validation
• UNKNOWN pour les commandes où les preuves disponibles sont insuffisantes pour attribuer une étiquette d'attribution plus forte

🕵️‍♂️ Sessions Agensic

Agensic enregistre les sessions interactives des agents, vous offrant une preuve irréfutable de ce qui s'est passé et la possibilité de manipuler en toute sécurité l'état du dépôt, via la fonctionnalité Time Travel.

✨ Fonctionnalités

▶️ Sessions rejouables

Besoin d'auditer la session d'hier soir pour comprendre ce qui s'est passé ? Exécutez agensic sessions et sélectionnez la session à rejouer. Notre IUT (interface utilisateur textuelle) ultra-rapide en plein écran vous permet de parcourir instantanément les chronologies, d'inspecter les charges utiles et de rejouer la session. Lorsque vous devez partager des preuves pour un examen d'incident, exportez l'ensemble de données exact en JSON ou CSV en une seule touche.

⏪ Voyage dans le temps

Vous êtes-vous déjà demandé : « À quoi ressemblait exactement mon dépôt juste avant que l'agent ne fasse ce commit destructeur ? » Le voyage dans le temps vous permet de rembobiner votre dépôt jusqu'à l'état Git exact capturé à un point de contrôle de session spécifique. Agensic restaure en toute sécurité les fichiers non suivis et modifiés dans une toute nouvelle branche, garantissant que vous ne détruisez jamais accidentellement votre arbre de travail en direct pendant l'enquête.

🗄️ État local résilient en priorité

Vos données restent les vôtres. Agensic utilise un backend d'état SQLite robuste avec un journal d'événements en ajout seulement et des instantanés automatisés. Cela signifie que votre historique forensique survit aux crashs inattendus du terminal, aux redémarrages du système et à une utilisation locale de longue durée sans corruption.

🤖 Agents pris en charge

Agensic prend en charge un ensemble d'agents intégrés préconfigurés qui peuvent être suivis :

• Claude Code
• Codex CLI
• Gemini CLI
• OpenClaw
• OpenCode
• Kimi Code
• Mini Agent
• Qwen Code
• GitHub Copilot CLI
• Kiro CLI
• Cline CLI
• Cursor CLI
• Nanoclaw
• Droid
• Hermes Agent
• Ollama
• Mistral Vibe
• Aider
• Pi.dev
• Kilo Code
• Continue CLI

Agents personnalisés : insérez n'importe quel exécutable d'agent dans la configuration d'Agensic et il fonctionnera immédiatement sans configuration

⚡ Autocomplétion Agensic

Agensic réinvente les suggestions du terminal. Contextuelles, sémantiques et toujours rapides, dans le style IDE, une autocomplétion Tab satisfaisante.

✨ Fonctionnalités

🚀 Suggestions d'historique local ultra-rapides

Dites adieu au décalage de saisie. Pendant que vous tapez, Agensic interroge un magasin de votre historique réel de commandes. Les suggestions apparaissent instantanément sous forme de texte fantôme que vous pouvez facilement accepter avec Tab. Parce qu'il apprend de vos habitudes et se base sur ce que vous faites réellement, les suggestions sont très précises et conscientes du dépôt.

🧠 Recherche sémantique et correction de fautes de frappe

Les humains font des erreurs, Agensic les corrige. Si vous tapez dokcer, Agensic suggère instantanément Vouliez-vous dire : docker. Vous ne vous souvenez pas de la syntaxe exacte ? Le reclassement sémantique sauvegarde votre intention, trouvant la bonne commande même si votre préfixe ne correspond pas parfaitement : si vous tapez docker records, vous obtiendrez Vouliez-vous dire : docker logs (à condition d'avoir déjà exécuté docker logs auparavant)

💡 Repli IA à la demande

L'IA est un repli puissant, pas une taxe sur chaque frappe. Agensic applique des budgets LLM par ligne pour empêcher le spam de prompts. Lorsque l'historique local ne suffit pas, un repli automatique LLM sera déclenché. Alternativement, vous pouvez toujours appuyer sur Ctrl+Espace pour récupérer manuellement une suggestion intelligente de votre LLM local ou hébergé préféré.

💬 Modes de commande en langage naturel

Oubliez la syntaxe exacte, décrivez simplement ce que vous voulez. Tapez quelque chose comme : # comment puis-je trouver tous les fichiers de plus de 10 Mo dans ce dossier ?. Agensic génère 3 commandes shell prêtes à copier et insère l'option la plus probable directement sur votre prochaine ligne. Besoin de conseils plutôt que de commandes ? Utilisez le mode assistant pour obtenir des réponses étape par étape directement dans votre terminal, ## Comment installer Node sur macOS ?. Vous voulez comprendre une commande avant de l'exécuter ? Utilisez : agensic --explain "votre commande ici"

🛡️ Préservation native de Tab et blocage des risques

Agensic respecte votre terminal. Il laisse Tab tranquille lorsque vous complétez des chemins de fichiers ou des scripts, donc la complétion native du shell reste gagnante là où elle est la meilleure. Plus important encore, les commandes destructrices (comme rm -rf, mkfs, ou dd) sont strictement bloquées des pools de suggestions afin que vous n'exécutiez jamais accidentellement une catastrophe.

🌐 Fournisseurs pris en charge

Agensic s'intègre à votre stack, que vous exécutiez des modèles localement ou que vous utilisiez des points de terminaison hébergés.

• Local : Ollama, LM Studio
• Hébergé : OpenAI, Anthropic, Gemini, Azure, DeepSeek, Groq, Mistral, Qwen (DashScope), MiniMax, Moonshot, OpenRouter, Xiaomi MiMo, Z.AI, AWS SageMaker
• Personnalisé : tout point de terminaison compatible OpenAI
• Historique uniquement : exécution entièrement hors ligne sans appels IA, en utilisant uniquement votre historique de commandes local

🧰 Commandes disponibles

Le tableau ci-dessous répertorie toutes les commandes CLI actuellement disponibles dans Agensic.

🔒 Sécurité et confidentialité

Agensic fonctionne sur le principe du moindre privilège et de la confidentialité maximale :

• Authentification locale : chaque route API localhost est strictement authentifiée avec une rotation automatique des jetons
• Rédaction des secrets : les valeurs à haute entropie, les identifiants d'URL et les formats de secrets connus (comme les clés AWS ou les JWT) sont supprimés et expurgés avant que toute donnée ne quitte votre machine pour un appel LLM
• Gardefous de commandes : les commandes destructrices sont strictement bloquées à la fois du moteur de suggestions et de la boucle de rétroaction
• Limitation de débit : les appels LLM sortants sont limités par des délais d'attente et des budgets stricts pour prévenir les abus d'API

👤 Créateur du projet

Alessio Leodori

🤝 Soutien

Vous trouvez Agensic utile ? Mettez une étoile ⭐️ au dépôt et parlez-en à un ami ! Cela nous aidera à grandir 🌱

📄 Licence

Agensic est open-source et sous licence Apache-2.0.