agentgrasp

agentgrasp

agentgrasp 可避免冗长的命令输出占用 Claude Code Agent 的上下文。Claude Code 仍会运行每条 Bash 命令。输出较长时，agentgrasp 会将其保存到文件中，并向 Agent 显示包含文件路径的简短摘要。Agent 随后可以读取该文件，或使用 ask 工具就文件内容提出是非问题。search 工具会查找与问题相关的文件和行范围，而不会返回源文本。

ask 和 search 使用 TypeSafe 的是非模型 Jev。

安装

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/damejeras/agentgrasp/releases/latest/download/agentgrasp-installer.sh | sh
claude plugin marketplace add damejeras/agentgrasp
claude plugin install agentgrasp@agentgrasp

除了使用安装程序，也可以通过 npm install -g agentgrasp 安装同一二进制文件，并通过 npx agentgrasp mcp 在不进行全局安装的情况下运行 MCP 服务。

插件会从 PATH 调用 agentgrasp。在启动 Claude Code 的环境中设置 TYPESAFE_API_KEY；如果没有设置，ask 和 search 会返回 provider_unavailable。

设置

agentgrasp 会将每条 Bash 命令放在 { ... } 分组中运行，并将其输出发送到文件。Claude Code 会要求批准每条包含此类分组的命令；即使允许规则允许该命令，也会要求批准，而且没有任何允许规则能改变这一点。因此，在 Claude Code 的默认权限模式和 acceptEdits 权限模式下，每次 Bash 调用都需要批准。在 bypassPermissions 模式下，调用会在不提示的情况下运行。你的拒绝规则仍会在所有模式下阻止命令。

启用 Claude Code 沙盒时，请允许 Bash 写入 agentgrasp 状态目录。否则，输出无法写入文件，Shell 会打印错误，且命令不会运行：

{
  "sandbox": {
    "filesystem": {
      "allowWrite": ["~/.local/state/agentgrasp"]
    }
  }
}

如果设置了 XDG_STATE_HOME，则改用 $XDG_STATE_HOME/agentgrasp。

费用与风险

• ask 和 search 会将文件内容发送给 TypeSafe。TypeSafe 将 Jev 的价格列为每十亿输入令牌 42 美元。每次调用都会将其使用的令牌数写入 ~/.local/state/agentgrasp/asks/ 或 searches/ 下的记录中。
• ask 和 search 可以读取 MCP 根目录中的任何文件，包括项目目录和你添加的目录。这也包括被 Read 拒绝规则拦截的文件。允许使用这些工具，就意味着允许这一点。
• 状态目录会一直增长，直到你删除其中的文件。agentgrasp 永远不会删除这些文件。
• 失控的命令可能会占满磁盘，直到 Claude Code 的超时机制停止它。

链接

• MCP Registry 名称：mcp-name: io.github.damejeras/agentgrasp