Gryph
为 AI 编程代理添加实时策略控制与本地审计记录。
- Star 数
- ★ 179
- 最近更新
- 2 天前
- License
- Apache-2.0
- 主语言
- Go
- FA 评分
- 78/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Claude CodeCodex（部分支持）
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 需要复查代理修改代码过程的开发者，可按会话查看文件读取、写入、回滚和命令的先后顺序。
- 不适合
- 需要集中式云端审计且不愿配置导出或云服务的团队
- 要求对抗同用户恶意行为者或 root 的团队
- 源码审查
- 78/100 · 表现良好
这个 Agent 能做什么，适合哪些场景？
Gryph 是一款通过轻量级钩子接入 AI 编程代理的命令行工具，覆盖文件读写和命令执行等操作。它将代理事件写入本地 SQLite 数据库，并提供 gryph logs、gryph query、gryph session 和 gryph export 等命令查看、筛选、回放及导出记录。可选的 YAML 策略按操作类型、路径、命令模式、工具、代理、项目和 CEL 会话计数器执行 block、warn、guide 或 allow。默认数据留在本机；敏感文件内容不存储，记录输出会进行凭据脱敏。Gryph 支持多种代理，并可通过导出、流目标或 SafeDep Cloud 将数据送出主机。
运行 gryph install 后，Gryph 为检测到的代理安装钩子。代理发起工具操作时，钩子把 JSON 事件发送给 Gryph；前置和后置工具事件用于记录操作生命周期，策略可在工具执行前作出决定。事件存入本地 SQLite，可用 gryph logs --live 实时查看、用 gryph query 筛选、用 gryph session 查看会话历史和差异，并以 JSONL 导出。默认导出配置会排除敏感内容，并将提示词导出为带密钥摘要。
- 需要复查代理修改代码过程的开发者，可按会话查看文件读取、写入、回滚和命令的先后顺序。
- 希望限制危险操作的安全团队，可编写 YAML 规则拦截破坏性命令或凭据泄露写入。
- 要发现未进入 Git 变更记录的副作用的团队，可查询
npm install、curl或rm等执行事件。 - 需要保护敏感文件的个人或团队，可利用自动检测记录访问，同时不保存匹配文件的内容。
- 比较不同代理行为或费用的开发者，可按代理筛选事件，并查看会话令牌用量和估算费用。
如何安装或部署这个 Agent？
README 的快速开始通过 shell 下载并运行安装脚本；也提供 Homebrew、npm、Go 安装方式。预编译版本面向 macOS、Linux 和 Windows。安装脚本需要网络连接；后续代理钩子会访问文件系统并调用 shell 命令。
curl -fsSL https://raw.githubusercontent.com/safedep/gryph/main/install.sh | sh
gryph install
gryph status如何使用这个 Agent？
安装后照常使用已接入的 AI 编程代理，再查看事件。策略配置可初始化、编辑、验证并启用。
gryph logs --live
gryph query --action exec --since "1w"
gryph sessions
gryph export --since 1dgryph policy init
gryph policy edit
gryph policy validate
gryph config set policy.enabled true这个 Agent 有哪些优点和局限？
- 事件存储于本地 SQLite，默认无需云服务即可查看和查询审计记录。
- 策略支持按路径、命令、代理等条件执行阻止、警告或引导，并记录决策。
- README 列出 Claude Code、Codex、Cursor、Devin CLI、Gemini CLI、OpenCode、Pi Agent 和 Windsurf 等集成。
- 需在代理配置中安装钩子；Codex 还要求启用
codex_hooks功能标志。 - 集中式审计、SIEM 或 SafeDep Cloud 需配置导出、流目标或云服务，数据默认仅留在本机。
- README 明确说明 guard 配置不能阻止同一用户的蓄意攻击者或 root。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Gryph 当前 | 78 · 表现良好 | 命令行工具免费 | ★ 179 | 2 天前 | Go | Claude Code |
| Kontext | 83 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 225 | 4 天前 | Go | Codex · Claude Code |
| 微软 Agent Governance Toolkit | 66 · 存在缺口 | 代码库 / SDK免费 | ★ 6.4k | 今天 | Python | Claude Code · OpenAI API |
| Node9 | 82 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 219 | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 描述了本地 SQLite、默认不发送数据、可选导出配置、敏感路径与内容处理；安装文件有 dry-run、备份、卸载和恢复方式，策略可按动作阻止。最小权限只获 2 分，因为常规安装会修改多个代理配置，managed 模式还涉及系统级安装；用户确认仅 1 分，材料说明 dry-run 和显式开启云端/导出，但未展示每项策略决定均需人工确认。依赖安全仅 1 分：go.mod 列出版本，CI 固定了部分 action SHA，但未见依赖审计或漏洞处置材料。身份归属仅 1 分，虽提到 SafeDep 和贡献渠道，发布者未经验证，维护者与更新责任仍不够明确。
README、工作流和验收目录相互支持多平台构建、测试、模糊测试、验收和基准流程，CLI 也提供 status、doctor 与错误退出码示例。自洽性得 2 分：材料覆盖面广，但支持代理数量和个别名称存在表述差异，且静态材料不能证明运行结果。依赖可用性得 2 分：提供 curl、Homebrew、npm、Go 和预编译版本等安装路由，但未说明离线安装或各渠道的长期可用性。失败消息得 2 分：文档列出部分退出码、错误位置和诊断命令，覆盖并不完整。
材料明确面向使用多种 AI 编码代理的开发者与受管主机管理员，列出代理、安装形态、策略规则和常见场景。能力边界得 3 分：明确指出 guard 不能阻止同用户的坚定攻击者或 root，并区分 managed 锁定能力及各代理差异。触发精度得 2 分：策略匹配项包括动作、路径、命令、工具、代理、项目和 CEL 条件，但文档没有完整展示规则冲突与匹配优先级。环境适配得 3 分：列出 macOS、Linux、Windows、各代理配置路径及受管主机设置。
README 有清晰目录、命令参考链接、安装步骤、示例、FAQ 式说明、隐私说明和限制文档入口；LICENSE 文件提供 Apache 2.0 全文。信息架构、安装说明、示例与已知限制均得 3 分。命名稳定性得 2 分：CLI 与代理名整体清楚，但文档中出现 Command Code 等名称，且概述中的代理列表与支持表范围不同。版本与变更记录仅得 1 分：有 release badge 和 @latest 安装指令，但所给材料没有 changelog 或版本兼容策略。维护责任得 2 分：有贡献指南、Issue、社区入口和定时文档检查，但具体维护团队与响应承诺未明确。
产品将代理动作记录、策略执行、会话查询、导出和成本追踪放在一个本地工具中，命令输出可用于 JSONL、jq、SIEM 与仪表板；多个场景说明了相较于只看最终 git diff 的额外价值。输出可用性和边际价值得 3 分。成本收益得 2 分：有多种安装渠道、默认本地运行和可选功能说明，但材料未量化部署维护成本、性能开销或各功能的实际收益。
README 对隐私、安装、策略和自保护的主张可对应到 LICENSE、go.mod、CI 工作流及验收保证目录；工作流也列出具体构建、测试、平台和验收任务。主张可追溯与跨材料互证得 3 分。事实与推断区分得 2 分：文档明确列出若干限制，但很多安全能力以产品方陈述和验收保证形式出现，所给材料没有实际运行记录；本评估因此不把这些视为独立验证。
- 本评估仅依据所给静态材料，置信度低；CI 与验收目录列出的流程和保证不代表本次已执行或独立验证。
- 安装会改写代理配置；启用 managed、完整日志、导出或云端功能前，应核对影响范围及所选数据配置。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Changelog * b8e260488bbbdd2140fed278f0b5893d9ac87753 Add Devin CLI agent adapter (#55)在 GitHub 查看 ↗ -
发布说明摘录
Changelog * 140df39202f0f9fa1266c63d6d5ec649e90e5947 Add policy authoring commands: list, install, and multi-file support (#49) * 316cfefb48ec7b4308a7c8def6b2dd2941782e5a Add real-binary acceptance suite with guarantee catalog (#50) * 7d3ebfcb9937c251979e3e40b42dfaf28bef655b Add robustness and adversarial acceptance guarantees (#52) * c9bbb0f82d91d6f147752ffa8edb1550bea78d7e Decouple agent adapters from the CLI, config, and tui layers (#54) * 1eb2b6a2003b7fa5282716378955eeb4457f6e77 Extend acceptance suite to 28 guarantees, macOS and release-binary CI (#51) …在 GitHub 查看 ↗ -
发布说明摘录
Changelog * 5d4975909aae6db542f1caa251f27a62c8090dbb feat(claudecode): wire DecisionGuidance through to hook output (#35) * 5a4ba4a24cfe7a3adf23f7f0f7e196f29e65eb7e feat(cli): add RegisterCheckFactory extension point for external binaries (#36) * 1443c8c233b4b47a18091a2043eaabb3aacc3856 feat: subagent observation for Claude Code (#38) * 61159f7b4f3fb783c1511828e47df2fb4add1a16 fix: Redact events and enforce log levels (#40) * a465597ee3b77db346925776547f1910d2891ae1 fix: respect XDG env vars across platforms, and show configured DB path in user-facing commands (#37) …在 GitHub 查看 ↗
常见问题
Gryph 会把日志发送到云端吗？
它能拦截代理操作吗？
安装支持哪些代理？
codex_hooks。敏感文件内容会被记录吗？
.env、密钥文件等模式的文件会被标记，操作会记录，但文件内容不会存储；日志输出也会自动脱敏凭据。