MoAI Web Console
6 つの領域(概要・ファクトリー・SPEC・モニター・設定・Todo)で構成されたローカル運用コンソール — リアルタイム更新、読み取り専用の観測、設定編集。
MoAI Web Console は moai web で起動するローカル運用画面です。プロジェクトの SPEC カタログ、ファクトリーレーン、セッションとゴール、検証履歴を一か所で確認でき、同じ画面から設定も編集できます。ブラウザは 127.0.0.1 にのみ接続し、データベースもログインもありません。
情報一言でいうと: コンソールは 5 つの観測領域と 1 つの設定領域を左レールにまとめた運用シェルです。観測領域は読み取りのみを行い、設定領域はターミナルウィザードと同じ検証・永続化レイヤーを使います。
画面は 3 つに分かれます。左のレールに 6 つの領域が縦に並び、上のアプリバーに現在の画面タイトルと状態が乗り、残りが本文です。どの領域にいてもレールとアプリバーは同じ位置に残ります。
| 領域 | ルート | 役割 |
|---|---|---|
| 概要(Overview) | / | プロジェクト全体の要約 — 統計タイル、進行中 SPEC、注意リスト、セッション |
| ファクトリー(Factory) | /factory | ファクトリーレーン一覧 + SPEC パイプライン 4 カラム |
| SPEC(Specs) | /specs | SPEC カタログの検索・フィルタ・詳細、クローズ負債と MUST-FIX drift |
| モニター(Monitor) | /monitor | セッション・ゴール・検証・エピックの 4 パネル |
| 設定(Settings) | /settings | プロファイル設定とプロジェクトセクションの編集 |
| Todo | /todo | バックログキューの読み取り専用ビュー — 3 状態のカードをすべて一覧 |
アプリバー右側に何が出るかは領域によって変わります。観測領域 5 つではリアルタイム表示灯が、設定領域では保存クラスター(変更件数と保存ボタン)が置かれます。コンテキストチップ(lang · model · effort · dev)は設定領域だけにレンダーされます — 編集中のプロファイルの主要な値を保存前に目で確認するためのものだからです。
レールの下部にはプロファイルボタン、プロジェクト名、インターフェース言語セレクター、終了ボタンが集まっています。プロファイルボタンを押すとポップオーバーが開き、切り替え・作成・名前変更・削除が一か所で完結します。どの画面から開いても同じポップオーバーなので、プロファイルを扱う面はコンソール全体で 1 つだけです。
flowchart TD
Rail["左レール
概要 · ファクトリー · SPEC · モニター · 設定 · Todo"]
Top["アプリバー
タイトル · リアルタイム表示灯 / 保存クラスター"]
Body["本文
領域ごとの画面"]
Read["読み取り専用領域
概要 · ファクトリー · SPEC · モニター · Todo"]
Write["設定領域
検証・永続化レイヤー経由"]
Files["プロジェクトファイル
.moai/ 配下の状態と設定"]
Rail --> Body
Top --> Body
Body --> Read
Body --> Write
Read -->|読み取りのみ| Files
Write -->|保存| Files
style Read fill:#E3F2FD,stroke:#1565C0
style Write fill:#FFF3E0,stroke:#E65100概要は 4 つの統計タイルから始まります。SPEC(全体件数と進行中の件数)、drift(MUST-FIX 件数)、session(PID 確認済みの数 / レジストリ登録数)、verify(最後の検証結果とキー数)です。
その下には進行中 SPEC の一覧、要注意パネル(MUST-FIX drift・失敗した検証・停滞したゴールだけを集めます)、右側にセッションパネルが置かれます。
ファクトリー領域には性格の異なる一覧が 2 つ、上下に置かれます。
ファクトリーレーンの一覧は、登録済みのレーンごとに 1 行を置き、セッション・カード・SPEC 識別子・バックエンドを記録します。ステージ状態はハートビートから推定した値なので推定マークが付き、モデル・推論強度・コンテキストはそのセッション自身のテレメトリ記録から取得します。空のセルは、その値を持つ記録がまだないことを意味します — 埋めないことが規律です。レーンのプロセス id がどのセッションにも届かない場合、またはどちらかのレジストリでセッション 1 つを特定できない場合、その行は確定不可としてマークされ、値を一つも持ちません。違うセッションで完了した照会が、他のレーンの記録をこのレーンのものとして描く方が、空の行より悪い結果だからです。登録されたレーンがなければ、ないと書きます。
SPEC パイプラインは SPEC を status 基準の 4 カラム(draft · in-progress · implemented · completed)に並べます。superseded · archived · rejected はこの一覧には来ず、SPEC 領域のフィルタからのみ確認します。
SPEC 領域の先頭には検索ボックスと status フィルタチップがあります。その直後、一覧より先に警告パネルが 2 つ来ます。
- クローズ負債(Close debt) — 実装は終わっているのに(
implemented)lifecycle がcompletedに閉じられていない SPEC です。件数が多いときは更新の新しい数件だけを表示し、切り詰めた事実と全体件数を併記します。 - MUST-FIX drift — 対処コマンドを伴う drift です。コマンドはコピーのみされます。コンソールはサーバー上でいかなるコマンドも実行しません — コピーして自分のターミナルで実行する構造です。
2 つのパネルが一覧の上に来る理由は単純です。カタログが数百行になると、下に置いたものは画面のはるか下方に押しやられ、事実上存在しないのと同じになるからです。
一覧は ID・タイトル・status・Tier・era・更新日・drift の列で構成されます。行を選ぶと右側に詳細パネルが開き、ドキュメント一覧、ファイルパス、drift の詳細を表示します。
| パネル | 読むもの |
|---|---|
| セッション(Sessions) | セッション id、SPEC、バックエンド、ハートビート、作業ディレクトリ |
| ゴール(Goals) | 設定されたゴールの条件、経過ターン数、停滞の有無、判定 |
| 検証(Verification) | キーごとの直近履歴スパークラインと合否 |
| エピック(Epics) | moai epic status が計算したエピックごとの進捗率 |
moai todo が書き込むバックログキューに専用のアドレスを与えました。この画面は 3 つの状態のカードをすべて並べます — queued・picked・dropped — それぞれの id、本文、状態バッジ、そして紐づく SPEC id があればそれも。何も絞り込みません。この画面が答えるべき問いは「あのカードはどこへ行ったのか」であり、待機中だけを映す作業ビューではその問いに答えられないからです。
読むだけです。追加・選択・破棄は moai todo の担当で、コンソールはキューに書き込まず、キューのロックも取りません。リンクされたワークツリーで開いても空にはならず、プライマリチェックアウトのキューが見えます — キューはリポジトリごとに 1 本の経路であり、どのファイルを見ているかが分かるよう、解決されたディレクトリをヘッダーに記します。
キューが存在しない場合や、正常に読み取ったキューにカードがない場合は、HTTP 200 と空のキューの案内を返します。読み取りに失敗した場合も HTTP 200 を返しますが、0 件と表示せず、読み取れなかったことを案内します。保存層の生のエラーは表示しません。
観測領域は監視中のファイルが変わると更新されます。サーバーは GET /events で SSE ストリームを開き、下表のプロジェクト内のパスと解決されたホームディレクトリを監視します。ファイル変更の通知は 250 ミリ秒単位でまとめて送ります。
要点はイベントがデータを運ばないことです。サーバーは「この領域が変わった」という名前だけを送り、ブラウザはその信号を受けて現在の画面を取り直し、本文だけを差し替えます。レンダリングの真実がサーバー 1 か所にのみ残るので、画面とファイルが食い違う状態は生まれません。
| イベント | 監視対象 |
|---|---|
spec | .moai/specs |
session | .moai/state |
goal | .moai/state/goal |
verify | .moai/state/verify |
factory | .moai/state/todo、解決されたホーム内の Todo ディレクトリ(~/.moai/db/<project-key>/todo)、解決された Factory ディレクトリ |
config | .moai/config/sections |
config イベントだけは扱いが異なります。設定を編集している最中に画面が下から変わると入力中の値が消えてしまうため、更新はせず「設定ファイルが変わった」というバナーだけを出します。
起動時に存在しなかったディレクトリは、1 秒ごとに監視の登録を再試行します。新しいディレクトリを登録すると、SSE 接続が正常な場合も更新信号を送ります。接続が切れると表示灯が切断状態になり、再接続に 3 回失敗すると、ブラウザは 30 秒間隔のポーリングに切り替わります。
コンソールが守る規律が画面のあちこちに現れます。
- セッションの活性はプロセスの生存を確認したものだけを活性に上げます。レジストリに記録が残っていてもプロセスが既に終了している場合があるため、確認できない項目は古いものとして表示します。
- ステージ状態はハートビートからの推定値であり、推定であるという事実をマークで併記します。
- 記録のない値(役割ごとのモデル・推論強度・コンテキスト使用量)はもっともらしい値で埋めず、空のままにします。セッション 1 つに紐づけられないファクトリレーンも、他のレーンの記録を借りて描かず確定不可として示します。
- 空のリストは空のままにせず「ない」と書きます。空のパネルは「まだ読めていない」と読まれるからです。
設定領域はコンソールで唯一ファイルを書く場所です。コンソールは独自の検証ルールを持たず、ターミナルウィザード(moai profile、moai update -c)と同じ検証・永続化レイヤーを呼びます。どちらから直しても結果が同じになる理由です。
レールで設定を選ぶと、その下に次のタブが縦のリストとして開きます。
- ユーザー情報(Identity) — 表示名とプロジェクト単位の identity フィールド
- 言語(Language) — 会話・コミットメッセージ・コードコメント・ドキュメントの言語
- CLAUDE 設定(Claude settings) — 権限モード・モデル・推論強度
- GLM設定(GLM Settings) — ティアごとの GLM モデル、ティアごとの推論強度、GLM API キー
- Codex 設定(Codex settings) — 散らばっている 散らばっている codex 設定を 1 画面にまとめて見せる読み取り専用のミラー。監査バックエンドと codex の固定値、codex を使うかどうか、検出された実行ファイルが一箇所に並びます。ここで値を直すことはなく、各行はその値を実際に持つタブへつながります
- ワークフロー(Workflow) — 実行モード・既定モード・agentic-loop・loop-prevention
- Git・ワークツリー(Git & Worktree) —
git_strategy.mode、プロファイルごとのmerge_method、ワークツリーと branch-guard のトグル - 監査(Audit) — 監査モデルとバックエンドごとのゲート
- レポート(Report) — レポート形式と出力の設定
- MCP —
moai mcp-serverのツールごとの有効トグル。書き込み可能なツールには区分マークが付きます - セッション間メッセージ(Cross-Session) — セッション間メッセージングの受信姿勢(posture): インバウンド処理方式(
accept·hold·refuse)、マシン間送信の隔離、保留対話の期限。crosssession.yamlを編集し、ランチャーが次回のmoai cc/glm実行からこの値をセッションに注入します — すでに動いているセッションは起動時の姿勢を保ちます - フィードバック — フィードバックワークフローが issue を出す対象リポジトリと、送信前の確認トグル
- 品質ゲート — コミット時の heavy ゲートを動かすかどうか。ランナーは
MOAI_PRECOMMIT=1のときだけこの値を見ます
各タブの横の数字は、そのタブがレンダーするフィールド数です。エラーのあるタブには数字の代わりに警告マークが付くので、どのタブを開くべきかが一覧からすぐ分かります。
codex の設定はもともと監査タブと MCP タブに分かれていました。「このプロジェクトは codex をどう使っているのか」を知るには 2 つのタブを行き来し、一度も一緒には表示されない値を読む必要がありました。Codex 設定タブはそれらを 1 画面にまとめます。
まとめて見せるだけで編集させないのは、未完成ではなく選んだ折衷です。 設定領域のパネルはすべて 1 つの <form> の中にあり、保存処理は同じ名前で送られてきた値のうち最初の 1 つだけを読みます。そのため同じ設定を 2 つのパネルでコントロールとして描くと、後ろのパネルで直した値が警告もなく捨てられます。bool 設定はさらに厄介で、付随する隠しフィールドだけが単独で置かれると 明示的な false として読まれるため、ページを開いて保存しただけで MCP ツールのトグルが 6 つ無効になります。
そこで Codex 設定タブは値とリンクだけをレンダーし、名前を持つ入力要素を 1 つも作りません。すべての設定は元のタブに宣言されたまま残り、編集もそこで行います。この画面を後から「編集できるように直す」ことは、上の損失をそのまま呼び戻すことです。
新しく増えた設定は 1 つもありません。 新しい設定キーも、新しい保存経路も、.moai/config 以下の新しいファイルもありません。設定はすでにあったもので、新しいのはそれをまとめて見る場所だけです。
MCP ツールのトグルはディスク上で空であることが多く、コンソールは空の値を有効として読みます。このタブはその空白を自分で解釈して二つ目の分類器になる代わりに (未設定) と書き、「値が空なら有効として扱い、明示的な false だけがツールを無効にする」という事実をグループ見出しに併記します。
フィールドは値の実際のドメインに合ったウィジェットでレンダーされます。bool フィールドはチェックボックスではなく 2 択のラジオグループで描きます — チェックボックスは現在の選択を隠しますが、ラジオの対は明示します。execution_mode や audit.model のような閉じた集合は select かラジオにし、集合外の値は保存時に拒否します。リポジトリパスや API キーのようにドメインが本当に開いている値だけが自由テキストとして残ります。
推論強度のランタイム伝達チャネルはセッション単位の環境変数 1 つだけなので、ティアごとに書いた推論強度は保存専用です。設定には残りますが、ランタイムはセッション単位の値だけを読みます。GLM設定タブには適用元を明示するバッジがあり、この事実が示唆ではなく明示として現れます。
編集できる範囲は単一の真実の情報源で決まっており、コンソールはその中にだけ書き込みます。user · language · quality · git-convention · git-strategy · llm は typed 検証パスで保存され、workflow と report はファイル内のコメントと行順を保つ seam で保存されます。マシン・状態セクションと大型ポリシーファイルは除外群であり、新しいセクションも明示的に登録されるまでは既定で拒否されます。各セクションのキーは config セクションリファレンス で扱います。
ループバック専用。 コンソールは 127.0.0.1 にのみバインドされるため、リモートホストからは届きません。ただしループバックのポートはアカウントごとに分かれていないので、同じマシンにログインしている別アカウントからは接続できます。
データベースなし。 別途 DB を立てません。読み書きする値は現在のプロジェクトの .moai/ 配下のファイルがすべてです。
認証なし。 ログインやトークンのレイヤーはありません。ループバックへのバインドはリモートホストを締め出しますが、同じマシンの別アカウントは締め出せません。複数人で使うマシンでは、コンソールが起動している間はそれらのアカウントからも接続できます。
コマンド実行なし。 観測領域は GET 以外のメソッドを拒否し、どの画面もサーバー上でコマンドを実行しません。SPEC の status 遷移もコンソールは行いません — 遷移の所有者は各フェーズのマネージャーエージェントです。
すべてのリクエストへの Host 検査。 静的ファイルを含むすべてのルートで、メソッドを問わず Host ヘッダーがループバック名(localhost・127.0.0.1・[::1]、ポートの有無は問わない)でない場合、またはヘッダー自体がない場合は 403 で拒否されます。ループバックへのバインドだけでは DNS リバインディングを防げないためです — 別サイトのページがブラウザを 127.0.0.1 に接続させつつ Host に攻撃者のドメインを乗せると、ブラウザはそのページに応答を読ませてしまいます。同一オリジン(Sec-Fetch-Site)検査は引き続き状態を変更するリクエストにのみ適用されます。
情報ループバック専用が認証なしの前提です。リバースプロキシや0.0.0.0バインドで外部に公開する構成はサポートしません。リモートから見る必要があれば SSH トンネルでローカルポートを転送してください。SSH トンネルを使う場合、ブラウザは引き続きlocalhostアドレスでコンソールを開くため、この検査下でも動作します。ただしこれは実際の SSH サーバーではなく、ポート転送をそのまま模した試験環境で確認した結果であり、検証済みの保証ではなく想定される挙動として理解してください。
インターフェース言語はレール下部のセレクターから English · 한국어 · 日本語 · 中文 のいずれかを選びます。選んだ言語はブラウザに残り、次に開くときは最初のレンダーから適用されます。docs-site の 4 ロケールドキュメント と同じ言語セットなので、画面とドキュメントを同じ言語で並べて読めます。
プロジェクトディレクトリで moai web を実行すると 127.0.0.1:3041 にバインドされ、ブラウザが自動的に開きます。
| フラグ | 既定値 | 動作 |
|---|---|---|
--port <int> | 3041 | バインドするループバックポート |
--no-open | false | ブラウザの自動起動を無効にします |
--no-reuse | false | ポートを使う古い moai インスタンスを回収せず、衝突として終了します |
終了はターミナルで Ctrl+C、またはレール下部の終了ボタンです。詳細は CLI リファレンス — moai web を参照してください。
- CLI リファレンス — moai web — フラグとルートの詳細
- ファクトリーモード — コンソールが描くチェーンの元となる規約
- config セクションリファレンス — 設定領域が扱うキー
- moai epic status — モニターのエピックパネルが読む成果物