GitBot

GitBot とは

GitBot は自分のマシンに入れる小さなサーバーだ。ブラウザのタブと、すでに課金しているコーディングエージェントの間に立ち、そのエージェントの仕事をボットとして保存する。ボットはどのリポジトリでも再び走らせられる。GitBot のアカウントは要らない。ファイルは手元に残り、外部との通信はエージェントが元々行うものだけだ。

狙いは繰り返しの解消にある。Claude Code も Codex も OpenCode も、前回の指示を忘れる。だから毎回、レビューをどう書いてほしいか、どのファイルが重要か、許可なく触ってよい範囲はどこかを説明し直すことになる。GitBot はその下準備をボットに残し、必要になったらフォルダに対してスレッドを開く。

仕組みを閉じる部品はあと二つある。スレッドはリポジトリに紐づく会話で、最初のターンを実行したエージェントに付いたまま残る。タブを閉じても、走っている応答に戻れる。セットアップ手順はマシンごとに一度だけ走る任意のコマンドで、道具が入っているかの確認や、本番作業前の環境準備に使う。

導入前に制約を知っておきたい。GitBot には認証がなく、すべてのネットワークインターフェースで待ち受ける。ポート 3000 に届く相手は、あなたのファイルとシェルの権限でエージェントを動かせる。MIT ライセンスの 0.0.x 版でもあり、機能は絞られ、粗い部分も残っている。

はじめかた

1. Node.js 18 以上と、コーディングエージェントを一つ用意する。claude の CLI、codex login 済みの codex、opencode auth login 済みの opencode のいずれかだ。
2. ターミナルで npm install -g @gitbot-hq/gitbot を実行する。
3. プロジェクトの入ったフォルダに移動し、gitbot start でローカル AI エージェントサーバーを起動する。ポートを変えるなら -p 4000、Mac を長い処理の間も眠らせないなら --caffeinate を足す。
4. 同じマシンで http://localhost:3000 を開き、Bots パネルのプラスを押して Create manually を選ぶ。
5. ボットに名前を付け、導入済みのエージェントを選び、固定の指示を書く。ボットの権限は Ask before each tool のままにしておく。そのあとスレッドを開き、リポジトリのフォルダを選んで最初のメッセージを送る。