← ブログに戻る
Ai読了目安 13 分

agent-autoloop は「人間待ち」をデータベースの一行として保存する

公開日 2026年11月15日
agent-autoloop は「人間待ち」をデータベースの一行として保存する

数週間おきに同じ光景を見る。ターミナルで coding agent を起動し、コーヒーを淹れに席を立ち、戻ってくると誰も見ていない質問の前で止まっている。ふつうの対処は通知音を大きくすることだ。agent-autoloop が狙うのはその下にある無駄で、プロセスとコンテキストウィンドウが開いたまま、何もせずに人間がキーボードから離れている時間そのものだ。

ローカル hub で、2026 年 11 月 15 日時点で GitHub スター 5,459、MIT ライセンス。イベントを監視し、すでに使っているコマンドライン agent に渡して、あとは横に引く。agent は 1 ラウンドを終え、答えを書き、終了する。判断が必要になると、hub がデスクトップにカードを送る。Feishu、DingTalk、WeCom、Slack、Discord でもいい。選択肢を選ぶ。agent はその会話を拾い直す。

クラウドの box も、開いたポートも、dashboard もない。

インストールと、動くことを証明する 1 コマンド

必要なのは Node 24 以降、Git、そしてインストール済みでログイン済みのコマンドライン agent 1 つ。macOS と Linux では curl も要る。

irm https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.ps1 | iex
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh

そのあと agent-autoloop try を実行する。バージョン番号を出すだけのインストールスクリプトは、あなたの agent のフラグとログインが動くことの証明にはならない。try は自分の agent で、本物の「問い合わせ、待機、回答、継続」のサイクルを 1 周する。イベントが出て、agent が働き、止まり、選択肢付きの質問をして、終了し、待つ。答えると hub がセッションを再開して終わらせる。設定が壊れていれば 2 分で分かる。cron ルールが誤爆する午前 2 時に分かるのではない。

契約は 1 文、ルールは 1 ファイル

hub と agent のあいだのインターフェースは 1 つの約束だけだ。結果を最後の返信に置く。SDK も wrapper も、パッチを当てたバイナリもない。プロンプトを受け取って最後のメッセージを出力するものなら何でもつながる。だから汎用のコマンドアダプタが Claude Code、Codex、ACP、DeepSeek Harness、ZCode と並んでいる。

質問は追記だ。agent は返信の末尾に agent-autoloop という名前のフェンス付きブロックを置き、その中に JSON を入れる。title、text、options、key を持つ ask 配列と、ほかの動詞に対応する notice、resolve、later、events。agent の作者が覚えるプロトコルはこれで全部だ。

ルールは ~/.agent-autoloop/rules.json にある。ルールは 3 つの問いに答える。何が起きたか、どの agent に渡すか、どのディレクトリで動かすか。

{
  "when": { "cron": "0 9 * * *" },
  "to": "codex",
  "cwd": "~/notes"
}

イベントルールは時計をソースに置き換える。GitHub の issues.opened にマッチさせ、parallel: 3 とスキルを足す。形は同じだ。設定は 2 ファイル、これと、あなたの agent がもともと読むファイルだけ。中身を確認できて diff が取りやすいところが気に入っている。

システム工学から借りた 4 つの機構

カーネルは設計が面白くなりはじめる場所だ。単体で見ると、新しいものはほとんどない。

まずゼロコストの停止。待っているあいだプロセスは終了し、状態はデータベースに移る。3 日黙っていれば、3 日ぶんトークンも動いている agent もない。残るのは hub だけで、動かしっぱなしにするには小さい。

次がイベントソーシング。状態はすべて append-only のログから導かれ、ログは hub が返信する前にインデックスと同じトランザクションで書かれる。プロセスを殺しても、確定した作業は残る。どのラウンドも後から番号で説明できる。スキーマ変更はマイグレーションスクリプトではなくログからの再構築で済む。

3 つ目が命令とデータの分離。issue のタイトルのような外部テキストは素材としてファイルに保存され、プロンプトに連結されることはない。プロンプトが運ぶのは検証済みの type、id、link だけ。どの agent が、どのディレクトリで、どんな権限で動くかは、すべてローカルのルールから決まる。cwd、agent、access を自分で持ってきたイベントは拒否される。

4 つ目が hop fuse で、これが一番好きだ。agent が生成したイベントを agent に戻すと深さが積み上がる。パケットが TTL を積むのと同じだ。人間の質問や予定された再確認はカウンタをリセットしないし、agent 自身も書き換えられない。8 レベルを超えると hub はディスパッチを止め、イベントを記録し、代わりにカードを送る。

数字と、どこから信じなくなったか

ベンチマーク表は Apple M5 Pro、24 GB、Node 24.21.0 で取られている。書き込みは 1 件ずつコミットし、返信の前にトランザクションをディスクへ。コールドスタート 88.78 ms。アイドルメモリ 59.94 MB RSS。長いポーリング 1,000 本同時で 170.49 MB。永続書き込みは毎秒 2,394 回。ディスパッチの p99 が 1.82 ms、キューに 5,000 件積んだ状態でハートビートの p99 が 1.66 ms。110 万ファクトからの起動が 99.8 ms。ランタイム依存はゼロ。

これはアプリの数字ではなくキューの数字で、そこが要点だ。待機を行として、作業をイベントとして保存する hub なら、キューと同じ振る舞いをするのが当然だ。

私の懐疑はこうだ。マシン 1 台、オペレータ 1 人、温まったページキャッシュ、そしてカーネルを書いた本人が書いたハーネス。ビデオ通話をしながらビルドが走るノート PC で benchmark が回されたことはない。下限として読み、約束として読まないこと。110 万ファクトという数字には、別の場所で正直な代償が添えられている。README には、フォーマット変更後の初回起動はログから再構築するとあり、それが 43.1 秒かかった。ノート PC なら許容範囲だが、そう思い込んでいると気まずい。

自律が牙をむく 2 か所と、引き継ぐもの

セキュリティは作者がいちばん賢ぶらなかった場所で、これは褒めている。命令とデータの分離により、悪意ある issue タイトルは別のディレクトリや別の agent に実行を向けられない。そのフィールドは入口で断られる。hop fuse により、agent 同士が仕事を回し続けても無限には回らない。深さを増やすのは参加者ではなく hub だからだ。

どちらも証明ではない。fuse は 8 レベルというポリシーだ。正当なワークフローが 9 を必要とするなら、それはあなたの問題だ。危険なのが、1 ホップごとに実害を出す遅い 2 レベルのループなら、fuse は決して発火しない。分離が守るのはディスパッチの判断であって、渡したディレクトリでシェルを取ったあとに agent がやることではない。

シミュレーションはたいていのプロジェクトより強い。node sim/random.ts 24301 200000 は固定シードで、切断、パケットロス、クラッシュ、二重送信を 20 万ステップ走らせるので、失敗を再現できる。node sim/crash.ts 1000 12648430 はプロセスを 1,000 回殺し、確定済みの記録が消えないことを確かめる。そのうえで README は、マシン全体の電源断は試していないと付け加える。この一文は尊敬するし、同時に何を試していないのかを問いたくなる。webhook テンプレートはローカルの mock サーバーにしか当てていない。GitLab webhook はドキュメントの形式と照合しただけで、本物の GitLab には一度も当てていない。レシピスクリプトは偽の Feishu CLI で検証された。「テスト済み」が読者の想定より軽い場所が、それぞれにある。

手書きのカーネルとランタイム依存ゼロで引き継ぐのは保守だ。小さい依存ツリーは、誰かが見ているあいだは年を取るほど良くなり、作者が離れると悪くなる。それが 88 ms のコールドスタートの代償だ。

課金の話は設計の外にある。hub はマシンに入ってログイン済みの CLI ツールを動かすので、利用量は自分のアカウントかサブスクリプションに乗る。README は、高頻度の自動化には API キーを、とベンダーが望んでいると注記している。個人プランは人間のペースの対話向けに作られているからだ。cron ルールを自分の Claude Code セッションに向けて寝る前に、この文を 2 回読んでほしい。

上のどの機構も防げないリスクが 1 つある。GitHub issue を立てられ、しかも配信パイプラインで deliver ラベルの付いた pull request をマージできるループは、あなたの認証情報を持つサプライチェーン上の行為者だ。ここまでの仕組みはそれを信頼できるものにし、短い綱につなぐ。それが悪いマージに至るかどうかを分けるのは、設定した review のステップだけで、どれだけ event sourcing を積んでも、読んでいない review は良くならない。

関連記事