agentgrasp

agentgrasp

agentgrasp は、長いコマンド出力が Claude Code エージェントのコンテキストに入らないようにします。Claude Code は引き続きすべての Bash コマンドを実行します。出力が長い場合、agentgrasp はそれをファイルに保存し、エージェントにはファイルパスを含む短い要約を表示します。エージェントはその後、ファイルを読み取るか、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 の状態ディレクトリへの書き込みを許可してください。許可しないと、出力をファイルに保存できず、シェルにエラーが表示されてコマンドは実行されません。

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

XDG_STATE_HOME が設定されている場合は、代わりに $XDG_STATE_HOME/agentgrasp を使用してください。

コストとリスク

• ask と search はファイルの内容を TypeSafe に送信します。TypeSafe によると、Jev の料金は入力トークン 10 億個あたり 42 ドルです。各呼び出しで使用したトークン数は、~/.local/state/agentgrasp/asks/ または searches/ 配下の記録に書き込まれます。
• ask と search は、MCP ルート内の任意のファイルを読み取れます。MCP ルートには、プロジェクトディレクトリと追加したディレクトリが含まれます。これには、Read の拒否ルールでブロックされるファイルも含まれます。これらのツールを許可する場合は、そのアクセスも許可することになります。
• 状態ディレクトリは、ファイルを削除するまで増え続けます。agentgrasp がファイルを削除することはありません。
• 暴走したコマンドによってディスクがいっぱいになることがあります。その場合、Claude Code のタイムアウトによって停止されます。

リンク

• MCP レジストリ名：mcp-name: io.github.damejeras/agentgrasp