Forensia de terminal criptográfica y reproducción de sesiones para agentes de IA. Rastrea, firma y audita cada comando con etiquetas de procedencia, sesiones reproducibles y viaje en el tiempo con Git. Prioriza la privacidad con almacenamiento local SQLite y redacción de secretos.
<p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/4480e118bb0f8f08f64f7da7573729d0dc6641679e7781e4c4050d939ea4d1b2.png" alt="Logotipo de Agensic" width="100%" /> </p> <h2 align="center">Sepa qué se ejecutó, dónde, cuándo y quién lo ejecutó</h2> <h3 align="center">La capa de observabilidad faltante para flujos de trabajo de terminal impulsados por IA</h3> <p align="center"> <code>Signed Provenance</code> <code>Tracked Sessions</code> <code>Git Time Travel</code> <code>Replayable Sessions</code> <code>IDE style Tab Autocomplete</code> </p> --- Agensic actualiza tu flujo de trabajo terminal existente para la era de la IA. Está construido para desarrolladores que quieren el impulso de productividad de los agentes de IA directamente en su shell, pero se niegan a comprometer la **auditabilidad, el control y la privacidad**. A medida que los agentes de IA toman cada vez más el control de la línea de comandos y ejecutan tareas de forma autónoma, la visibilidad y el control se vuelven críticos. Agensic trata **los comandos de terminal como ciudadanos de primera clase** y proporciona un marco robusto para rastrearlos, inspeccionarlos y gestionarlos. En lugar de aplanar toda la actividad del terminal en un único "historial de shell" ambiguo, Agensic actúa como un observador forense y un copiloto inteligente. Rastrea sin problemas las sesiones interactivas de codificación con IA, firma criptográficamente los comandos ejecutados por agentes y proporciona un autocompletado tipo IDE ultrarrápido respaldado por el historial. --- ## 📋 Tabla de Contenidos 1. [Soporte de Plataforma](#-platform-support) 2. [Instalación](#-installation) 3. [Inicio Rápido](#-quick-start) 4. [Agensic Provenance](#-agensic-provenance) - [Características](#-features-provenance) - [Etiquetas Soportadas](#-supported-labels) 5. [Agensic Sessions](#-agensic-sessions) - [Características](#-features-sessions) - [Agentes Soportados](#-supported-agents) 6. [Agensic Autocomplete](#-agensic-autocomplete) - [Características](#-features-autocomplete) - [Proveedores Soportados](#-supported-providers) 7. [Comandos Disponibles](#-available-commands) 8. [Seguridad y Privacidad](#-safety--privacy) 9. [Creador del Proyecto](#-project-creator) 10. [Soporte](#-support) 11. [Licencia](#-license) --- ## 💻 <a id="-platform-support"></a>Soporte de Plataforma Agensic está diseñado para integrarse profundamente con tu entorno de shell. - macOS (Zsh) — totalmente compatible ✅ - Linux (Bash) — totalmente compatible ✅ --- ## 🚀 <a id="-installation"></a>Instalación El camino más rápido es el instalador gestionado de una sola línea: ```bash curl -fsSL https://raw.githubusercontent.com/Alex188dot/agensic/main/bootstrap.sh | bash ``` Si prefieres clonar manualmente: ```bash git clone https://github.com/Alex188dot/agensic.git cd agensic bash ./install.sh ``` Si ya tienes `uv`, el instalador lo usará automáticamente para una configuración más rápida. En la primera ejecución, Agensic te pedirá que elijas tu proveedor LLM preferido y configure tus claves API para el autocompletado de comandos. Alternativamente, puedes configurar tu proveedor LLM y tus claves API ejecutando: ```bash agensic setup ``` ## ⚡ <a id="-quick-start"></a>Inicio Rápido Después de la configuración, **abre una nueva terminal** y Agensic comenzará automáticamente a rastrear tu actividad en la terminal y a proporcionar sugerencias de autocompletado mientras escribes! ### 🤖 Seguimiento Automático de Agentes sin Interrupciones Comienza a trabajar, como lo harías normalmente, por ejemplo usando tu asistente de codificación con IA favorito, como Claude Code, Codex CLI, etc: ```bash claude ``` o ```bash codex ``` Consulta la sección [Agentes Soportados](#-supported-agents) para obtener una lista completa de todos los agentes compatibles. Si tu agente no está en la lista, puedes agregarlo ejecutando <code>agensic --add_agent "ejecutable"</code> y luego usarlo normalmente para que Agensic pueda rastrearlo. Cuando hayas terminado, puedes usar Agensic para inspeccionar el historial de la sesión: ```bash agensic sessions ``` o ver la procedencia forense: ```bash agensic provenance ``` --- ## 🧾 <a id="-agensic-provenance"></a>Agensic Provenance Agensic te da una transcripción forense para cada comando. Clasifica lo sucedido, registra metadatos enriquecidos y muestra una pista de auditoría clara para que puedas saber si un comando fue escrito manualmente, aceptado de una sugerencia o ejecutado directamente por un agente. <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/954db235102e042437af9e18befe1d48176d543e55a5bd8ba5cc3ff7a8396f41.gif" alt="Demostración de procedencia de Agensic" width="75%" /> </p> ### <a id="-features-provenance"></a>✨ Características ### 🔍 Explorador de Procedencia a Pantalla Completa <p> ¿Necesitas responder: "¿Qué se ejecutó exactamente aquí y quién lo desencadenó?" Ejecuta <code>agensic provenance</code> para abrir el visor de procedencia a pantalla completa. Filtra por etiqueta, agente, proveedor o ventana de tiempo, inspecciona la secuencia exacta de comandos y exporta la vista actual a JSON o CSV cuando necesites un registro duradero para depuración, revisión de incidentes o cumplimiento normativo. </p> ### 🛡️ Procedencia y Firma Criptográfica de Comandos <p> Deja de adivinar si un humano o una IA rompió la compilación. Agensic captura metadatos enriquecidos para cada comando y utiliza la firma local Ed25519 para etiquetar las ejecuciones realizadas por agentes con una innegable etiqueta <code>AI_EXECUTED</code>. Obtienes una línea de tiempo clara y auditable que separa las pulsaciones de teclado humanas de las sugerencias de IA y las ejecuciones automatizadas. </p> ### 🏷️ Etiquetas de Atribución Estructuradas <p> Agensic no reduce el historial del terminal a una lista cruda de cadenas. Cada comando rastreado se clasifica en una etiqueta de procedencia, dándote una forma consistente de filtrar ejecuciones, investigar comportamientos y entender cómo un comando ingresó a tu shell en primer lugar. </p> ### <a id="-supported-labels"></a>🔖 Etiquetas Soportadas Agensic actualmente soporta las siguientes etiquetas de procedencia: - <code>AI_EXECUTED</code> para comandos ejecutados directamente por un agente de IA con prueba firmada - <code>HUMAN_TYPED</code> para comandos escritos manualmente por un humano en el shell - <code>AI_SUGGESTED_HUMAN_RAN</code> para comandos sugeridos por una llamada LLM externa de IA y luego ejecutados por un humano - <code>AG_SUGGESTED_HUMAN_RAN</code> para comandos sugeridos por Agensic y luego ejecutados por un humano - <code>INVALID_PROOF</code> para comandos que llegaron con metadatos de prueba que fallaron la validación - <code>UNKNOWN</code> para comandos donde la evidencia disponible es insuficiente para asignar una etiqueta de atribución más fuerte --- ## 🕵️♂️ <a id="-agensic-sessions"></a>Agensic Sessions Agensic registra sesiones interactivas de agentes, brindándote una prueba innegable de lo sucedido y la capacidad de manipular de forma segura el estado del repositorio, a través de la función Time Travel. <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/5a2de01b27f96092f2a728dcd93c9368336747306cea978c81b18ad3b6714f5e.gif" alt="Demostración de repetición de Agensic" width="75%" /> </p> ### <a id="-features-sessions"></a>✨ Características ### ▶️ Sesiones Reproducibles <p> ¿Necesitas auditar la sesión de anoche para entender lo que sucedió? Ejecuta <code>agensic sessions</code> y selecciona la sesión que deseas reproducir. Nuestra TUI ultrarrápida a pantalla completa te permite navegar instantáneamente por las líneas de tiempo, inspeccionar cargas útiles y reproducir la sesión. Cuando necesites compartir evidencia para una revisión de incidentes, exporta el conjunto de datos exacto a JSON o CSV con una sola pulsación de tecla. </p> ### ⏪ Time Travel <p> ¿Alguna vez te has preguntado: "¿Cómo se veía exactamente mi repositorio antes de que el agente hiciera ese commit destructivo?" Time Travel te permite retroceder tu repositorio al estado exacto de Git capturado en un punto de control de sesión específico. Agensic restaura de forma segura los archivos no rastreados y modificados en una nueva rama, asegurando que nunca destruyas accidentalmente tu árbol de trabajo activo mientras investigas. </p> ### 🗄️ Estado Resiliente de Prioridad Local <p> Tus datos siguen siendo tuyos. Agensic utiliza un backend de estado SQLite robusto con un diario de eventos de solo adición y capturas de instantáneas automatizadas. Esto significa que tu historial forense sobrevive a fallos inesperados del terminal, reinicios del sistema y uso local prolongado sin corrupción. </p> ### <a id="-supported-agents"></a>🤖 Agentes Soportados Agensic proporciona soporte para un conjunto de agentes integrados preconfigurados que pueden ser rastreados: - 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 Agentes Personalizados: inserta cualquier ejecutable de agente en la configuración de Agensic y funcionará inmediatamente sin configuración adicional. --- ## ⚡ <a id="-agensic-autocomplete"></a>Agensic Autocomplete Agensic reimagina las sugerencias del terminal. Autocompletado con Tab consciente del contexto, semántico y siempre rápido al estilo IDE. <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/f710d6a7c01b14691b1d825894e1640c2a92ff1642178a5aed2b3d7d0ac241e3.gif" alt="Demostración de autocompletado de Agensic" width="50%" /> </p> ### <a id="-features-autocomplete"></a>✨ Características ### 🚀 Sugerencias Ultrarrápidas del Historial Local <p> Di adiós al retraso de entrada. Mientras escribes, Agensic consulta un almacén de tu historial de comandos real. Las sugerencias aparecen instantáneamente como texto fantasma, que puedes aceptar fácilmente con <code>Tab</code>. Como aprende de tus patrones y se basa en lo que realmente haces, las sugerencias son altamente precisas y conscientes del repositorio. </p> ### 🧠 Búsqueda Semántica y Recuperación de Errores Tipográficos <p> Los humanos cometen errores, Agensic los corrige. Si escribes <code>dokcer</code>, Agensic sugiere instantáneamente <code>Did you mean: docker</code>. ¿No recuerdas la sintaxis exacta? La reclasificación semántica rescata tu intención, encontrando el comando correcto incluso si tu prefijo no coincide perfectamente: si escribes <code>docker records</code> obtendrás <code>Did you mean: docker logs</code> (siempre que hayas ejecutado <code>docker logs</code> anteriormente). </p> ### 💡 Recurso Alternativo de IA Bajo Demanda <p> La IA es un recurso alternativo poderoso, no un impuesto en cada pulsación. Agensic aplica presupuestos de LLM por línea para evitar el spam de indicaciones. Cuando el historial local no es suficiente, se activará el recurso alternativo automático de LLM. Alternativamente, siempre puedes presionar <code>Ctrl+Space</code> para obtener manualmente una sugerencia inteligente de tu LLM local o alojado preferido. </p> ### 💬 Modos de Comando en Lenguaje Natural <p> Olvida la sintaxis exacta, solo describe lo que quieres. Escribe algo como: <code># how can I find all files larger than 10MB in this folder?</code>. Agensic genera 3 comandos de shell listos para copiar e inserta la opción más probable directamente en tu siguiente línea. ¿Necesitas orientación en lugar de comandos? Usa el modo asistente para obtener respuestas paso a paso directamente en tu terminal, <code>## How do I install Node on macOS?</code>. ¿Quieres entender un comando antes de ejecutarlo? Usa: <code>agensic --explain "your command here"</code> </p> ### 🛡️ Preservación Nativa de Tab y Bloqueo de Riesgos <p> Agensic respeta tu terminal. Deja <code>Tab</code> intacto cuando estás completando rutas de archivos o scripts, por lo que la finalización nativa del shell sigue siendo la mejor donde corresponde. Más importante aún, los comandos destructivos (como <code>rm -rf</code>, <code>mkfs</code>, o <code>dd</code>) están estrictamente bloqueados de los grupos de sugerencias para que nunca ejecutes accidentalmente un desastre. </p> ### <a id="-supported-providers"></a>🌐 Proveedores Soportados Agensic se adapta a tu pila tecnológica, ya sea que ejecutes modelos localmente o uses endpoints alojados. - **Local:** Ollama, LM Studio - **Hosted:** OpenAI, Anthropic, Gemini, Azure, DeepSeek, Groq, Mistral, Qwen (DashScope), MiniMax, Moonshot, OpenRouter, Xiaomi MiMo, Z.AI, AWS SageMaker - **Custom:** cualquier endpoint compatible con OpenAI - **Solo Historial:** ejecuta completamente sin conexión sin llamadas de IA, usando solo tu historial de comandos local ## 🧰 <a id="-available-commands"></a>Comandos Disponibles La tabla a continuación enumera todos los comandos CLI actualmente disponibles en Agensic. | Comando | Qué hace | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | <code>agensic --help</code> | Muestra la ayuda principal de la CLI y todos los comandos estándar para el usuario | | <code>agensic --version</code> | Imprime la versión instalada de Agensic y sale | | <code>agensic update</code> | Descarga e instala la última versión publicada de Agensic en GitHub | | <code>agensic setup</code> | Abre el flujo de configuración interactivo para Agensic Sessions y Autocomplete | | <code>agensic enable-startup</code> | Configura Agensic para que se inicie automáticamente al iniciar sesión o arrancar | | <code>agensic first-run</code> | Ejecuta el flujo de incorporación de la primera instalación | | <code>agensic start</code> | Inicia el demonio en segundo plano de Agensic manualmente | | <code>agensic stop</code> | Detiene el demonio de Agensic | | <code>agensic logs</code> | Sigue la salida del registro del demonio en tiempo real | | <code>agensic test</code> | Envía una solicitud de autocompletado de prueba al demonio para verificar la conectividad | | <code>agensic provenance</code> | Abre la vista del historial de procedencia de comandos. Soporta filtros como <code>--limit</code>, <code>--label</code> y <code>--contains</code> | | <code>agensic sessions</code> | Abre el navegador de sesiones rastreadas. Usa <code>--text</code> para salida en texto plano | ## 🔒 <a id="-safety--privacy"></a>Seguridad y Privacidad Agensic opera bajo el principio de mínimo privilegio y máxima privacidad: - **Autenticación Local:** cada ruta API de localhost está estrictamente autenticada con rotación automática de tokens. - **Redacción de Secretos:** los valores de alta entropía, las credenciales de URL y los formatos de secretos conocidos (como claves de AWS o JWTs) se eliminan y redactan **antes** de que cualquier dato salga de tu máquina para una llamada LLM. - **Guardarraíles de Comandos:** los comandos destructivos están bloqueados de forma permanente tanto en el motor de sugerencias como en el bucle de retroalimentación. - **Límite de Tasa:** las llamadas LLM salientes están limitadas por tiempos de espera y presupuestos estrictos para evitar el abuso de la API. --- ## <a id="-project-creator"></a>👤 Creador del Proyecto Alessio Leodori ## <a id="-support"></a>🤝 Soporte ¿Te resulta útil Agensic? Dale estrella ⭐️ al repositorio y cuéntaselo a un amigo. ¡Esto nos ayudará a crecer 🌱! ## 📄 <a id="-license"></a>Licencia Agensic es de código abierto y está licenciado bajo la **Licencia Apache-2.0**.
