Repolode
投稿する
robbin

robbin/grokbot-local-agent

Grok Botが重いコーディングや執筆作業を同じマシン上のローカルPiエージェントに委任し、完了時にwebhookで通知を受け取るためのスクリプトです。

GitHub で見る
スター
86
フォーク
11
未解決の Issue
0
最終コミット
12 日前

これは何？

grokbot-local-agentは、Grok Botから同じLinuxマシン上のローカルコーディングエージェントPiに作業を委任するスクリプト群です。ファイルの一括編集、小規模なスクリプト、長文の執筆、調査といった負荷の高い作業は、ユーザー自身のモデルアカウントを使ってPiで実行されるため、Botのサブスクリプション利用枠を消費しません。

委任された各呼び出しはタスクとして追跡され、ステータスと成果物が~/.pi/tasks/<ID>/に保存されます。タスクが完了すると、webhookにはID、所有者、状態、終了コードだけが送られ、Botは通知を受けてファイルを読み込み、結果を検証して報告し、タスクを確認済みにできます。所有者で絞り込むpending、list、ackコマンドにより、複数のBotが互いの作業を報告するのを防ぎます。また、pendingを使えば通知を受け損ねた後でも結果を確認できます。

このプロジェクトは、隔離されたサンドボックスサービスではなく、Botと同じマシン上で動く軽量な補助ツールです。Node 22以降が必要で、クライアントスクリプトにサードパーティ製の依存関係はありません。

主な機能

  • 01同じマシン上でPiコーディングエージェントを使って委任された作業を実行します。
  • 02各タスクのID、ステータス、成果物をディスク上で追跡します。
  • 03完了時にwebhookを送信し、Botが結果を検証して報告できるようにします。
  • 04pending、list、ackを所有者のagent IDで絞り込み、Bot間での誤報告を防ぎます。
  • 05後続ターン、キャンセル、固定モデルを使う同期実行のショートカットに対応しています。
  • 06オプションのTelegramモニターで、Piセッションの進捗をプライベートチャットに通知します。

ユースケース

  • サブスクリプションの利用枠に制限があるチャットBotから、ファイルの一括編集や小規模なスクリプト作成を切り離す。
  • Botの会話ターンが終了した後も、長文の執筆や調査を続ける。
  • webhookによる通知をきっかけに、バックグラウンドのコーディングタスクの検証済みレポートを受け取る。
  • Telegramを使い、スマートフォンから委任したエージェントのセッションをリアルタイムで追う。

クイックスタート

  1. 1

    Node 22+ と Pi コーディングエージェントをインストールします

    npm i -g --prefix ~/.local @earendil-works/pi-coding-agent
  2. 2

    pi を対話モードで起動し、/login を入力してモデルに自分でログインします

  3. 3

    スクリプトを ~/tools/pi-call にコピーします

    mkdir -p ~/tools/pi-call && cp -a bin/. ~/tools/pi-call/
  4. 4

    OK と表示されるはずのスモークテストを実行します

    ~/tools/pi-call/pi-run /tmp "Reply with only OK" --timeout 120

使う前に知っておきたいこと

  • Node 22+ と、別途用意したモデルアカウントまたはサブスクリプションが必要です。認証は自分で行う必要があります。
  • Grok Bot ホスト上で webhook ルーチンとシークレットの設定が必要なため、セットアップの手間が増えます。
  • 軽量なヘルパーであり、隔離されたサンドボックスではありません。また、強力な権限分離機能もありません。

収録されている特集

オープンソースの AI エージェント・フレームワークとアプリAI コーディングアシスタントとエージェント

トピック

#ai-agent#local-agent#webhook#automation#task-queue#coding-agent#telegram

よくある質問

grokbot-local-agent とは？
Grok Botが重いコーディングや執筆作業を同じマシン上のローカルPiエージェントに委任し、完了時にwebhookで通知を受け取るためのスクリプトです。 grokbot-local-agentは、Grok Botから同じLinuxマシン上のローカルコーディングエージェントPiに作業を委任するスクリプト群です。ファイルの一括編集、小規模なスクリプト、長文の執筆、調査といった負荷の高い作業は、ユーザー自身のモデルアカウントを使ってPiで実行されるため、Botのサブスクリプション利用枠を消費しません。
grokbot-local-agent は無料で使えますか？ライセンスは？
grokbot-local-agent は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
grokbot-local-agent は今もメンテナンスされていますか？
活発にメンテナンス中。grokbot-local-agent の最終コミットは 2026年10月26日 です。
grokbot-local-agent は何に使えますか？
サブスクリプションの利用枠に制限があるチャットBotから、ファイルの一括編集や小規模なスクリプト作成を切り離す。 Botの会話ターンが終了した後も、長文の執筆や調査を続ける。 webhookによる通知をきっかけに、バックグラウンドのコーディングタスクの検証済みレポートを受け取る。 Telegramを使い、スマートフォンから委任したエージェントのセッションをリアルタイムで追う。
grokbot-local-agent のインストール方法は？
Node 22+ と Pi コーディングエージェントをインストールします: npm i -g --prefix ~/.local @earendil-works/pi-coding-agent pi を対話モードで起動し、/login を入力してモデルに自分でログインします スクリプトを ~/tools/pi-call にコピーします: mkdir -p ~/tools/pi-call && cp -a bin/. ~/tools/pi-call/ OK と表示されるはずのスモークテストを実行します: ~/tools/pi-call/pi-run /tmp "Reply with only OK" --timeout 120
grokbot-local-agent はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/robbin/grokbot-local-agent

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト