Agente Pike

O pike-agent registra e analisa como os programas se comportam no Linux. Ele rastreia a atividade de um programa, indexa em um banco de dados e permite que você converse com um agente LLM sobre isso em uma TUI.

Exemplo de prompts:

• Diagnóstico de falha: Este programa travou com um erro de barramento. O que aconteceu?
• Detecção de condição de corrida: Existem condições de corrida em como este programa cria arquivos temporários?
• Triagem de malware: Encontrei este processo rodando em um servidor de produção. Devo me preocupar?

Veja Diga olá ao Pike! para uma introdução.

Como funciona

O pike-agent usa strace para registrar cada chamada de sistema que um programa faz, e então as indexa em um banco de dados SQLite com pesquisa de texto completo. Um agente LLM consulta este banco de dados por meio de chamadas de ferramentas para responder suas perguntas sobre o comportamento do programa.

• Suporta inferência local (llama.cpp) e APIs externas (Claude, Gemini, etc.)
• Pesquisa de texto completo sobre argumentos de chamadas de sistema
• Consulta de man pages para documentação de chamadas de sistema

Instalação

uv pip install -e .

Requer Python 3.13+ e strace instalado no sistema.

Uso

Na primeira execução, um arquivo de configuração padrão é criado em ~/.config/pike-agent/config.toml. Edite-o para configurar seu provedor de inferência e modelo. Por padrão, ele aponta para um servidor llama.cpp local.

Pike-agent funciona melhor com modelos que são bons em chamada de ferramentas, por exemplo: Gemini 3 Pro, Qwen 3.5, Claude 4.6 Sonnet...

Gravando um rastreamento

Rastreie um comando:

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

Anexe a um processo em execução:

pike-agent attach 1234

Ambos produzem um arquivo .db com o rastreamento indexado.

Conversando com o agente

Inicie uma sessão de chat em um rastreamento gravado:

pike-agent chat trace.db

Licença

GPLv3.