OpenAIのCodex CLIに搭載された /goal コマンドは、長期タスクをエージェントに自律的に実行させる機能です。しかし目標が曖昧なまま渡すと、エージェントは関係のない変更を量産し、完了していないのに「done」を宣言することがあります。GoalBuddy はその問題を解決するオープンソースのローカルツールです。
この記事でわかること：
- Codex
/goalが抱える「ゴールのドリフト」問題 - GoalBuddy が準備する2つのファイルの役割
- Scout / Judge / Worker の役割分担
- インストールから
/goal実行までの手順 - GitHub・Slack・Linear との拡張連携
https://github.com/tolibear/goalbuddy
Codex /goal とは何か
OpenAI は2026年4月30日、Codex CLI 0.128.0 で /goal コマンドを正式リリースしました。1つの目標をセッションをまたいで持続させ、完了まで自律的にループを回す機能です。タスクを渡してPCを閉じても、再開すると続きから動きます。
有効化の手順はシンプルです。
npm install -g @openai/codex@latest
codex features enable goals
有効化後は Codex 内で /goal <目標> と入力するだけで長期実行が始まります。
曖昧なゴールが引き起こす問題
/goal このプロジェクトを改善して のような広い指示を渡すと、Codex は何をどこまでやるかの基準を持てません。タスクが無限に膨らみ、スコープ外のファイルを変更し続けることがあります。検証も甘くなり、実際には完了していないのに処理を終えてしまうケースも出てきます。
OpenAI も /goal はまだ開発中の機能と位置づけており、長期タスクを安定して動かすには周辺の設計が必要です。
GoalBuddy が解決すること
GoalBuddy は「/goal に乗せる前の設計図を作るツール」です。曖昧なゴールを機械が読める構造に変換し、Codex が何をすべきか・どこまで終わったかを常に把握できる状態を作ります。
準備されるファイルは2種類です。
goal.md：目標・制約・完了条件を記述するチャーターstate.yaml：タスクの状態・担当エージェント・完了レシートを追跡するボード
この2ファイルを /goal に読み込ませることで、Codex のループが目標からずれにくくなります。ファイルは docs/goals/<スラッグ>/ 以下にローカル保存されるため、バージョン管理もできます。
Scout / Judge / Worker の役割分担
GoalBuddy は3種類のエージェントを導入します。タスクは常に1つだけ「active」の状態を保ち、並列処理による脱線を防ぎます。
Scout（スカウト） はリポジトリの状態・制約・リスクを調査し、次のタスク候補を洗い出します。「このプロジェクトを改善して」のような幅広い指示が来たとき、最初のステップは必ず Worker（実装）ではなく Scout（調査）です。
Judge（ジャッジ） はスコープの曖昧さを解決し、次に何をすべきかを決定します。Scout の調査結果と goal.md の完了条件を照合し、実装に進んでよいかを判断します。
Worker（ワーカー） は Judge が承認したタスクのみを実装します。変更対象ファイルと検証条件が事前に明示されるため、スコープ外の変更は発生しません。タスク完了ごとに証跡（レシート）が state.yaml に記録されます。
ループの流れはこうなります。
曖昧なゴール → Scout → Judge → Worker → レシート → 検証 → 繰り返し
インストールと使い方
Node.js が入っていれば、npx 一発で動きます。
npx goalbuddy
グローバルインストールも可能です。
npm i -g goalbuddy
インストール後は Codex を再起動し、$goal-prep コマンドでボードを初期化します。GoalBuddy はボードを準備し、次に実行すべき /goal コマンドを出力するところまでを担います。実装の開始は /goal に委ねます。
/goal Follow docs/goals/<slug>/goal.md.
事前に Codex の goals 機能が有効か確認しておくと確実です。
codex features enable goals
npx goalbuddy doctor --goal-ready
ボードの健全性チェックもコマンド一発でできます。
node ~/.codex/skills/goalbuddy/scripts/check-goal-state.mjs docs/goals/<slug>/state.yaml
拡張機能
GoalBuddy のコアは npm パッケージとして安定提供され、拡張は GitHub ホスト型のカタログから別管理されます。npm リリースを待たずに新しい連携を追加できる仕組みです。
npx goalbuddy extend install --all
現在利用可能な拡張には github-pr-workflow（レシートと整合したコミット・PR テキストの自動準備）があります。GitHub・Slack・Linear との連携もこの仕組みで順次追加される予定です。
まとめ
GoalBuddy は Codex /goal を安定して使うための補完ツールです。MIT ライセンスで公開されており、npx goalbuddy で即座に試せます。2026年5月時点で GitHub スター数は256に達しており、Shopify・Tencent・Zendesk などのチームにも導入されています。Codex での長期タスクが脱線しやすいと感じているなら、まずローカルで動かしてみる価値があります。