Pike 代理

pike-agent 记录并分析程序在 Linux 上的行为。它追踪程序的活动，将其索引到数据库中，并让您通过 LLM 代理在 TUI 中与之聊天。

提示词示例：

• 崩溃诊断：这个程序因总线错误崩溃了。发生了什么？
• 竞态条件检测：这个程序创建临时文件的方式是否存在竞态条件？
• 恶意软件分类：我在生产服务器上发现了这个进程。我该担心吗？

参见 向 Pike 打个招呼！ 以了解介绍。

工作原理

pike-agent 使用 strace 记录程序执行的每个系统调用，然后将其全文索引到 SQLite 数据库中。LLM 代理通过工具调用查询该数据库，以回答您关于程序行为的问题。

• 支持本地推理 (llama.cpp) 和外部 API (Claude、Gemini 等)
• 系统调用参数的全文搜索
• 系统调用文档的 man 手册查询

安装

uv pip install -e .

需要 Python 3.13+ 并在系统上安装 strace。

使用

首次运行时，会在 ~/.config/pike-agent/config.toml 创建一个默认配置文件。编辑它以配置您的推理提供程序和模型。默认指向本地 llama.cpp 服务器。

Pike-agent 最适合与擅长工具调用的模型配合使用，例如：Gemini 3 Pro、Qwen 3.5、Claude 4.6 Sonnet...

记录追踪

追踪一个命令：

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

附加到正在运行的进程：

pike-agent attach 1234

两者都会生成一个带有索引追踪记录的 .db 文件。

与代理聊天

在已记录的追踪上启动聊天会话：

pike-agent chat trace.db

许可证

GPLv3.