numbat agents命令完全指南：一条命令盘点你机器上的全部AI编码助手-育师

【免费下载链接】numbat

Visibility into AI agent activity on endpoints, with on-device detection, optional pre-action blocking, and forensic reconstruction.

项目地址：https://gitcode.com/gh_mirrors/numbat/numbat

点击查看免费下载

numbat是一款面向终端的 AI 编码助手行为监控工具，提供本地检测、可选的事前拦截和取证重建能力。而numbat agents是其中最轻量的一条命令：只读扫描你的机器，输出一张 AI Agent 盘点表——谁装过、有没有会话记录、numbat 是否已接入监控，一眼看清。全程不安装任何内容、不执行任何 Agent 程序，对系统零改动。

为什么需要 AI Agent 盘点命令？

如今一台开发机上往往同时装着 Claude Code、Codex、Cursor、Copilot CLI、Gemini CLI 等好几款 AI 编码助手。它们各自把配置和会话记录写在不同的隐藏目录里（如~/.claude、~/.codex、~/.cursor），手动翻找费时费力。

numbat agents帮你回答三个问题：

我机器上到底装了哪些 AI 编码助手？
哪些有本地会话产物可供事后扫描？
哪些已经接入了 numbat 的实时监控？

它的实现位于 cmd/numbat/agents.go，命令设计原则写得很明确：只出报告（REPORT-ONLY），不安装、不写配置、绝不运行 Agent 二进制。

快速上手：安装并运行 numbat agents

先获取 numbat 单文件二进制（支持 macOS、Linux、Windows 的 amd64/arm64），或通过 Go 安装：

go install github.com/perplexityai/numbat/cmd/numbat@latest

然后在任意目录执行：

numbat agents

命令会解析用户主目录，检查各 Agent 的已知配置目录、会话记录根目录以及 hook 接线状态，最后打印一张对齐的文本表格。官方 CLI 参考见 docs/cli.md。

读懂盘点表：5 列输出分别代表什么？

默认输出是一张 6 列的表格，以本机装有 Codex 并安装了 hook 为例：

AGENT CONFIG ARTIFACTS LIVE WIRED NEXT Codex yes found transcripts hooks yes install: numbat hook install --agent codex

列名	含义
`AGENT`	Agent 显示名（如 Claude Code、Cursor、OpenClaw）
`CONFIG`	是否检测到本地配置目录（`yes`/`no`），这是"装过没"的核心信号
`ARTIFACTS`	静态会话产物扫描结果：`found transcripts`（找到记录）、`none found`、`scan error`，或`n/a (hook-only)`（仅支持实时监控、无本地解析器）
`LIVE`	实时采集方式：`hooks`（生命周期钩子）、`plugin`（生成的插件/扩展）或`none`（仅取证扫描）
`WIRED`	numbat 是否已把配置写入该 Agent（`yes`/`no`/`error`）；注意它只证明配置存在，不代表运行时已激活
`NEXT`	下一步建议命令，照着做即可完成接入

默认只列出本机有信号的 Agent；扫描中断的条目会被如实标注（如none found (partial scan: 1 skipped)），而不是假装"没有"。

两个实用参数：--all 与 --format json

numbat agents支持两个参数，覆盖绝大多数使用场景：

# 显示完整支持矩阵，包括本机未安装的 Agent numbat agents --all # 输出 JSON，方便接入脚本或审计流程 numbat agents --format json

--all：把 numbat 支持的每一个本地 Agent 都列出来，即使本机没装也占一行。适合安全团队核对比对："理论上我们该管哪些 AI 助手？" 参数定义见 cmd/numbat/agents.go。
--format json：输出结构化数组，每行含agent、detected、at_rest、hook、wired、setup_hint、at_rest_scan_incomplete字段。机器可读的at_rest_scan_incomplete字段能区分"确认没有"和"扫描不完整"，适合自动化巡检。

numbat agents 支持哪些 AI 编码助手？

--all会列出完整的 Agent 清单，涵盖 CLI、IDE、桌面与网关型 Agent 三大类：

CLI 类：Claude Code、Codex、Gemini CLI、GitHub Copilot CLI、Kimi Code、Qwen Code、Cline CLI、Devin CLI、Grok Build、Hermes 等
IDE / 桌面类：Cursor、Windsurf / Devin Desktop、VS Code Copilot Chat、Kiro IDE、OpenCode、Amp、Auggie、Kilo Code、Antigravity、Junie
网关 / 其他：OpenClaw、OpenHands、Goose、Crush、Factory Droid、Claude Cowork、Pi

完整的支持矩阵（含各 Agent 的产物路径、实时采集与拦截能力）以官方覆盖表为准：docs/agent-coverage.md。

常见问题：退出码与"没检测到"意味着什么？

numbat agents的退出码语义简单明确（见 cmd/numbat/agents.go）：

退出码	含义
`0`	报告正常完成。一个 Agent 都没检测到也算成功，不是错误
`1`	连用户主目录都无法解析（没有可扫描的机器）
`2`	用法错误（如`--format`传了非法值、多了位置参数）

几个新手容易困惑的点：

表格为空：说明主目录下没有发现任何 Agent 信号，属正常结果。
WIRED=yes≠ 已生效：它只表示 numbat 拥有的配置存在且可读，是否被 Agent 加载激活需在对应客户端里确认。
环境变量重定位也认：CODEX_HOME、CLAUDE_CONFIG_DIR、GEMINI_CLI_HOME等常见覆盖变量都会被尊重，目录搬走也不会漏报。

盘点之后的下一步：scan 与实时监控

agents的NEXT列就是行动指南。典型的跟进流程：

# 只读扫描全部已发现的 Agent 会话产物，输出 NDJSON 记录 numbat scan # 只看某一个 Agent 的产物 numbat scan --agent codex # 为某 Agent 安装实时监控（默认仅监控模式，不拦截） numbat hook install --agent codex --emit all

scan读取磁盘上的会话产物并运行内置规则检测；hook install之后进入实时采集。内置规则全部为监控模式，拦截（enforce）需要操作者显式配置，详见 docs/enforcement.md。