agensic v0.3.0

Sepa qué se ejecutó, dónde, cuándo y quién lo ejecutó

La capa de observabilidad faltante para flujos de trabajo de terminal impulsados por IA

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

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
2. Instalación
3. Inicio Rápido
4. Agensic Provenance
   • Características
   • Etiquetas Soportadas
5. Agensic Sessions
   • Características
   • Agentes Soportados
6. Agensic Autocomplete
   • Características
   • Proveedores Soportados
7. Comandos Disponibles
8. Seguridad y Privacidad
9. Creador del Proyecto
10. Soporte
11. Licencia

💻 Soporte de Plataforma

Agensic está diseñado para integrarse profundamente con tu entorno de shell.

• macOS (Zsh) — totalmente compatible ✅

• Linux (Bash) — totalmente compatible ✅

🚀 Instalación

El camino más rápido es el instalador gestionado de una sola línea:

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

Si prefieres clonar manualmente:

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:

agensic setup

⚡ 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:

claude

o

codex

Consulta la sección Agentes Soportados para obtener una lista completa de todos los agentes compatibles. Si tu agente no está en la lista, puedes agregarlo ejecutando agensic --add_agent "ejecutable" y luego usarlo normalmente para que Agensic pueda rastrearlo.

Cuando hayas terminado, puedes usar Agensic para inspeccionar el historial de la sesión:

agensic sessions

o ver la procedencia forense:

agensic provenance

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

✨ Características

🔍 Explorador de Procedencia a Pantalla Completa

¿Necesitas responder: "¿Qué se ejecutó exactamente aquí y quién lo desencadenó?" Ejecuta agensic provenance 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.

🛡️ Procedencia y Firma Criptográfica de Comandos

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

🏷️ Etiquetas de Atribución Estructuradas

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.

🔖 Etiquetas Soportadas

Agensic actualmente soporta las siguientes etiquetas de procedencia:

• AI_EXECUTED para comandos ejecutados directamente por un agente de IA con prueba firmada
• HUMAN_TYPED para comandos escritos manualmente por un humano en el shell
• AI_SUGGESTED_HUMAN_RAN para comandos sugeridos por una llamada LLM externa de IA y luego ejecutados por un humano
• AG_SUGGESTED_HUMAN_RAN para comandos sugeridos por Agensic y luego ejecutados por un humano
• INVALID_PROOF para comandos que llegaron con metadatos de prueba que fallaron la validación
• UNKNOWN para comandos donde la evidencia disponible es insuficiente para asignar una etiqueta de atribución más fuerte

🕵️‍♂️ 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.

✨ Características

▶️ Sesiones Reproducibles

¿Necesitas auditar la sesión de anoche para entender lo que sucedió? Ejecuta agensic sessions 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.

⏪ Time Travel

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

🗄️ Estado Resiliente de Prioridad Local

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.

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

⚡ Agensic Autocomplete

Agensic reimagina las sugerencias del terminal. Autocompletado con Tab consciente del contexto, semántico y siempre rápido al estilo IDE.

✨ Características

🚀 Sugerencias Ultrarrápidas del Historial Local

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 Tab. Como aprende de tus patrones y se basa en lo que realmente haces, las sugerencias son altamente precisas y conscientes del repositorio.

🧠 Búsqueda Semántica y Recuperación de Errores Tipográficos

Los humanos cometen errores, Agensic los corrige. Si escribes dokcer, Agensic sugiere instantáneamente Did you mean: docker. ¿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 docker records obtendrás Did you mean: docker logs (siempre que hayas ejecutado docker logs anteriormente).

💡 Recurso Alternativo de IA Bajo Demanda

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 Ctrl+Space para obtener manualmente una sugerencia inteligente de tu LLM local o alojado preferido.

💬 Modos de Comando en Lenguaje Natural

Olvida la sintaxis exacta, solo describe lo que quieres. Escribe algo como: # how can I find all files larger than 10MB in this folder?. 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, ## How do I install Node on macOS?. ¿Quieres entender un comando antes de ejecutarlo? Usa: agensic --explain "your command here"

🛡️ Preservación Nativa de Tab y Bloqueo de Riesgos

Agensic respeta tu terminal. Deja Tab 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 rm -rf, mkfs, o dd) están estrictamente bloqueados de los grupos de sugerencias para que nunca ejecutes accidentalmente un desastre.

🌐 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

🧰 Comandos Disponibles

La tabla a continuación enumera todos los comandos CLI actualmente disponibles en Agensic.

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

👤 Creador del Proyecto

Alessio Leodori

🤝 Soporte

¿Te resulta útil Agensic? Dale estrella ⭐️ al repositorio y cuéntaselo a un amigo. ¡Esto nos ayudará a crecer 🌱!

📄 Licencia

Agensic es de código abierto y está licenciado bajo la Licencia Apache-2.0.