agensic v0.3.0
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.
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
- Soporte de Plataforma
- Instalación
- Inicio Rápido
- Agensic Provenance
- Agensic Sessions
- Agensic Autocomplete
- Comandos Disponibles
- Seguridad y Privacidad
- Creador del Proyecto
- Soporte
- 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_EXECUTEDpara comandos ejecutados directamente por un agente de IA con prueba firmadaHUMAN_TYPEDpara comandos escritos manualmente por un humano en el shellAI_SUGGESTED_HUMAN_RANpara comandos sugeridos por una llamada LLM externa de IA y luego ejecutados por un humanoAG_SUGGESTED_HUMAN_RANpara comandos sugeridos por Agensic y luego ejecutados por un humanoINVALID_PROOFpara comandos que llegaron con metadatos de prueba que fallaron la validaciónUNKNOWNpara 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.
