Agente Pike

pike-agent registra y analiza cómo se comportan los programas en Linux. Rastrea la actividad de un programa, la indexa en una base de datos y te permite chatear con un agente LLM al respecto en una TUI.

Ejemplo de indicaciones:

• Diagnóstico de fallos: This program crashed with a bus error. What happened?
• Detección de condiciones de carrera: Are there any race conditions in how this program creates temporary files?
• Triaje de malware: I found this process running on a production server. Should I be worried?

Consulta Say hi to Pike! para una introducción.

Cómo funciona

pike-agent utiliza strace para registrar cada llamada al sistema que realiza un programa, luego las indexa en una base de datos SQLite con búsqueda de texto completo. Un agente LLM consulta esta base de datos a través de llamadas a herramientas para responder a tus preguntas sobre el comportamiento del programa.

• Admite inferencia local (llama.cpp) y APIs externas (Claude, Gemini, etc.)
• Búsqueda de texto completo en argumentos de syscalls
• Consulta de páginas man para documentación de syscalls

Instalación

uv pip install -e .

Requiere Python 3.13+ y strace instalado en el sistema.

Uso

En la primera ejecución, se crea un archivo de configuración predeterminado en ~/.config/pike-agent/config.toml. Edítalo para configurar tu proveedor de inferencia y modelo. Por defecto apunta a un servidor local de llama.cpp.

Pike-agent funciona mejor con modelos que son buenos en el uso de herramientas, por ejemplo: Gemini 3 Pro, Qwen 3.5, Claude 4.6 Sonnet...

Grabación de un rastro

Rastrear un comando:

pike-agent run -- ./my-program --flag

Adjuntar a un proceso en ejecución:

pike-agent attach 1234

Ambos producen un archivo .db con el rastro indexado.

Conversar con el agente

Iniciar una sesión de chat sobre un rastro grabado:

pike-agent chat trace.db

Licencia

GPLv3.