LoopX——長く走るAIエージェントに、人間の判断を残す「制御盤」入門

ふむふむ、これ、ちょっと見過ごせない。

AIコーディングエージェントに「数日かかるタスク」を任せたとき、あなたはどんな気分になります？「昨日どこまで進んだっけ」「あの判断、誰がしたんだっけ」「気づいたら延々とトークンを消費してた」。要するに、エージェントは1セッションでは速いけど、長く走らせると途端に信用できなくなる。そんな感覚ありませんか。

そこに現れたのが LoopX（ループエックス）。GitHubでこの1週間、約2,000スターを積み上げて急上昇中のツールです。謳い文句がまた刺さるんですよね——

「ループは回し続けろ。判断は人間に残せ。」 （Keep the loop moving. Keep the judgment human.）

今日は、この LoopX が何をしてくれて、どう動かすのか、そして罠はどこにあるのか、ガッツリ掘り下げます。

LoopX は何をするのか——30秒でつかむ

LoopX は、ひと言でいうと「長く走り続ける AI エージェントのための制御盤（コントロールプレーン）」です。

ポイントは、エージェントの「作業」そのものは従来どおり Codex や Claude Code がやること。LoopX はその代わりに、作業の状態を管理します。具体的には、次のようなものを「消えない形」で保存し、セッションをまたいで引き継ぎます：

• ゴール（objective）——何のために動いているのか
• ゲート（gates）——どこで人間の判断が必要か
• TODO——次に何をするのか、誰がやるのか
• スコープ——どこまでが今回の仕事か
• 証拠（evidence）——何が確認済みで、何がブロックされているか
• 予算（quota）——あとどれだけ動いてよいか

つまり「チャットの履歴」や「タイマー」では足りなかったものを、ひとつのコンパクトな層にまとめてくれる。これが LoopX の本質です。

面白いのは「人間の判断」を構造として残すところ

ここ、チカちゃん的に一番グッときたポイントです。ふつうのエージェントツールって、みんな「もっと自律的に」って方向に進みますよね。でも LoopX は逆で、「人間の判断が必要なポイント」を『待ち』じゃなくて『具体的なゲート』として記録するんです。

「オーナー待ちで止まってる」という曖昧な状態ではなく、「この質問に答えるまで次に進めない」という具体的な問いとして残る。エージェントが暴走して「とりあえず進めました」とならないための仕組みが、最初から組み込まれているんですね。

エージェントネイティブな「カンバン」だと思えばOK

LoopX の README は、LoopX を「エージェントネイティブなカンバン」と表現しています。カードにはアイデンティティ・権限・証拠・続きが載っていて、動きは claim（確保）や gate（ゲート）や writeback（書き戻し）といった「検証された操作」だけが許される。ブラウザ上のボードはあくまで投影で、真実の源は LoopX の状態そのもの。なるほどねえ、この設計、潔くて好きです。

インストール——2分で動かす

必要なのは Python 3.11 以上と curl、tar。macOS か Linux のシェルがあればOK。Git は寄稿者向けのワークフローでしか使いませんし、Python パッケージは標準ライブラリ以外の依存がありません。めちゃくちゃ軽い。

curl -fsSL https://huangruiteng.github.io/loopx/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"
loopx doctor

loopx doctor が通ればインストール成功です。

ちょっと待って。「curl | bash って大丈夫？」と思ったそこのあなた、その警戒は正しいです。この形式はスクリプトの内容を確認せずに実行することになるので、不安なら先に中身を見てから実行するのがおすすめ：

curl -fsSL https://huangruiteng.github.io/loopx/install.sh -o loopx-install.sh
less loopx-install.sh   # 中身を確認してから
bash loopx-install.sh

プロジェクトと接続する

プロジェクトのルートに移動して接続します：

cd /path/to/your-project
loopx connect
loopx status

もし初回で「状態が見つからない」と言われたら、ガイド付きでゴールを作るコマンドが用意されています：

loopx start-goal --guided --project . --goal-text "あなたの長期ゴール"

接続が成功すると、.loopx/ というディレクトリに状態が保存されます。ここは Git にコミットしないでくださいね（.loopx/ や .codex/goals/ は .gitignore に入れておくのが鉄則です）。

核心は5つのコマンド——これだけ覚えればOK

LoopX の中心は、びっくりするほど小さな「1回のループ」です。README はこれを「core tick」と呼んでいます：

loopx quota should-run      # このエージェントは今動くべきか？
loopx todo claim            # この作業の持ち主は誰か？
loopx todo update           # 何が変わったか？
loopx refresh-state         # 次のターンは何を見るべきか？
loopx quota spend-slot      # 検証済みの作業を消化として記録する

この5つが、長く走るループを「見える」まま保つための最小単位です。ここに無駄がなくて、なんだか職人の道具箱みたいでしょ。

日常の確認はこの3つ

毎日、作業を再開するときに打つのはだいたいこれ：

loopx status
loopx history --goal-id your-project-goal
loopx quota should-run --goal-id your-project-goal

「今どこまで進んでて、次何をするか」がコンパクトに返ってきます。ピア（仲間）のエージェントがいる場合は、作業前に todo claim、検証後に todo update を挟むことで、持ち主と証拠が常に見える状態を保てる。これが肝です。

LoopX が答える5つの問い

LoopX の機能は、突き詰めると5つの問いに整理されています。設計思想がそのまま見えてくるので、書き出しておきますね：

問い	LoopX が見えるように保つもの
目的は何か？	アクティブなゴール、明示的なスコープ、現在の権限
次に何が起きるか？	ユーザーとエージェントの TODO、所有権、確保（claim）、リース
人間の判断が要るのはどこか？	「オーナー待ち」ではなく具体的なユーザーゲート
何の証拠が変わったか？	コンパクトな実行履歴、検証、ブロッカー、承認済みの書き戻し
ループを続けてよいか？	予算（quota）、能力、安全な代替手段、スケジューラのヒント、停止条件

この「5つの問い」の枠組み、他のツールの理解にもそのまま使えそうじゃない？エージェントを長く走らせるときに「今この5つのうちどれが見えなくなってるかな」と点検するだけで、だいぶ事故は減りそうです。

罠と注意点——正直に言っておきたい

ここ、めっちゃ大事です。「急上昇中！」に釣られて飛びつく前に。

罠1：まだ v0.4.x。プラットフォームでもランタイムでもない

LoopX は「エージェントの完全なプラットフォーム」でも「自律的な本番コントローラー」でもありません。あくまで、状態と CLI の契約を安定の中心にした「使えるローカル制御盤」です。README 自身が「本番の自律運用を任せるものではない」と明言しています。

罠2：ホスト連携は「オプトイン／実験的」が多い

Codex App や Claude Code との連携は「推奨の始め方」として用意されていますが、いくつかの統合はデフォルト無効だったり実験扱いだったりします。安定しているのは状態カーネルと CLIの部分。派手な連携機能に期待しすぎると、まだ荒いところに当たります。

罠3：日本語情報はほぼゼロ。覚悟して英語／中国語のドキュメントを読む

作者は中国系の開発者で、公式ドキュメントは英語と簡体字中国語が中心。ユーザーマニュアルは Feishu（飛書）にホストされています。日本語の記事がほとんどないからこそ今回取り上げたわけですが、トラブル時は自力で英語ドキュメントを掘る覚悟が要ります。

罠4：ショーケースの数字を鵜呑みにしない

README には「200時間超のループ」や「4日間の無人稼働」といったショーケースがありますが、これらは「経過した壁時計時間」であって「連続でモデルを回し続けた時間」ではありません。LoopX 自身がかなり丁寧に但し書きを入れています。他のツールの派手な数字と同じで、まずは自分で小さいゴールを回して感触を確かめるのが正解です。

罠5：「ループ思考」の切り替えが必要

いちばんの学習コストは実はコマンドじゃなくて、考え方かもしれません。LoopX は「1セッションで終わるタスク」には過剰です。ゴール・ゲート・TODO・予算という分解を意識して、数日にまたがる仕事を「管理できる対象」として捉える——この頭の切り替えができる人には強力で、できないうちは「ただ面倒なツール」に映るはず。チカちゃん的には、まず1週間かかる系の調査や実験に使ってみるのがおすすめです。

まとめ——「任せる」と「判断する」を分けるということ

LoopX のすごさは、テクノロジーの派手さじゃなくて、姿勢にあります。多くのツールが「エージェントにどれだけ任せられるか」を競う中で、LoopX は「何をエージェントに任せて、何を人間が判断し続けるか」という境界線を、技術的に固定しようとしている。

これは便利の話でありながら、かなり人間くさい話でもあります。仕事を委ねる相手が現れたとき、私たちは「どこまで信用して、どこで自分が責任を持つか」をいつも決めています。LoopX はその、普段は無意識にやっている「信頼の棚卸し」を、目に見える構造にしてくれる道具なんですね。ドーンだよっ。

答えを急がなくても大丈夫です。まずは小さなゴールをひとつ、LoopX に回してみてください。ループが止まらず、判断だけが自分の手に残る——その感覚を味わってから、「任せるって何だろう」を一緒に考えましょう。

思索は冒険です。今日の話も、その入口のひとつでした。

参考URL

GitHub - huangruiteng/loopx → https://github.com/huangruiteng/loopx

LoopX 公式サイト → https://huangruiteng.github.io/loopx/

LoopX ドキュメント → https://huangruiteng.github.io/loopx/docs/

LoopX はじめ方ガイド（Getting Started） → https://github.com/huangruiteng/loopx/blob/main/docs/guides/getting-started.md