核心用法
IDE Agent Kit 是一个面向多IDE代理协调的工具集，采用分层安全架构：核心功能完全基于本地文件系统，无需任何网络连接或凭证；高级功能需显式配置才激活。
四种工作模式自由组合：
1. 本地文件系统总线（默认）：代理通过 ./ide-agent-queue.jsonl 和 ./ide-agent-receipts.jsonl 交换消息，零网络依赖
2. Webhook中继服务器（可选）：serve 命令启动本地HTTP服务（默认 127.0.0.1:8787），接收GitHub/GitLab webhook并写入本地队列
3. Ant Farm轮询（可选）：poll 命令连接Ant Farm房间实现跨机协调，需显式提供API密钥
4. GitHub事件集成（可选）：配合serve使用，需配置 github.webhook_secret 验证签名
命令执行安全机制：
tmux run和exec受限于配置文件的tmux.allow白名单，默认仅允许：npm test、npm run build、pytest、git status、git diffexec额外引入审批流：需先exec request→ 人工/代理exec resolve后才执行
显著优点
| 维度 | 说明 |
|------|------|
| **默认安全** | 无配置即纯离线运行，所有凭证字段初始为空，高级功能需显式opt-in |
| **零依赖** | 核心功能不依赖外部服务，单文件队列+日志实现协调 |
| **网络最小化** | 核心命令（`init`、`receipt tail`、`memory`、`keepalive`）零网络流量 |
| **执行沙箱** | 命令白名单+可选审批流，降低RCE风险 |
| **可验证** | npm包无install脚本，纯ESM JavaScript，可 `npm pack --dry-run` 审计 |
潜在缺点与局限性
- 功能边界依赖配置：高级功能（
sessions、gateway、poll）需外部服务（OpenClaw、Ant Farm）配合，单工具无法独立完成跨机协调 - 本地Webhook局限：
serve默认仅绑定回环地址，如需公网访问需额外反向代理配置 - 轮询延迟：Ant Farm轮询默认120秒间隔，实时性有限
- 白名单维护成本：自定义构建命令需手动更新
tmux.allow配置 - AGPL-3.0许可： copyleft性质可能对某些商业场景产生兼容性顾虑
适合人群
- 使用Claude Code、Cursor等多IDE环境的开发者，需要在不同会话间同步上下文
- 追求本地优先、数据主权的隐私敏感用户
- 需要轻量级CI/CD webhook处理的solo开发者或小团队
- 愿意接受显式安全配置而非默认全开的安全意识用户
常规风险
| 风险类别 | 等级 | 说明 |
|---------|------|------|
| 供应链攻击 | 低 | 无install脚本，源码可审计，npm包与GitHub仓库可交叉验证 |
| 凭证泄露 | 中 | `ide-agent-kit.json` 可能包含 `openclaw.token` 和 `github.webhook_secret`，需按敏感文件管理 |
| 命令注入 | 低 | 白名单机制有效限制，但配置篡改可导致绕过 |
| 网络暴露 | 低 | `serve` 默认localhost，误配为 `0.0.0.0` 可能暴露webhook端点 |
| 数据残留 | 中 | `ide-agent-receipts.jsonl` 和队列文件包含完整操作历史，共享工作目录可能泄露敏感上下文 |