Inspectrum

Set up Inspectrum's Codex plan gate. Use normal approvals only — do not
switch to Bypass Permissions or Full Access.

Steps:
1. Run `node --version`. If < 20, stop and tell me to install Node 20+
   from https://nodejs.org first.
2. Run `codex --version`. If it is missing or older than 0.99.0, run
   `npm install -g @openai/codex@latest` and verify again.
3. Run `claude plugin marketplace add yannmenec/inspectrum`, then
   `claude plugin install inspectrum@inspectrum`.
4. Run `claude mcp add --transport stdio --scope user inspectrum -- npx -y inspectrum@latest`
   (this powers the on-demand /inspectrum:review command).
5. Run `npx -y inspectrum@latest doctor` and show me the output,
   including the resolved codex model/effort lines.
6. Run `codex login status`.
   - If it prints "Logged in", tell me: "✅ Setup complete. Your next
     plan-mode plan gets a Codex review automatically." Done.
   - Otherwise (not logged in), pop open a Terminal window with codex
     already running by executing:
       `osascript -e 'tell application "Terminal" to do script "codex"'`
     Then tell me: "A Terminal window opened with codex running.
     Inside that window, click 'Sign in with ChatGPT', complete the
     login in my browser, then close the Terminal window. Inspectrum
     is then ready."

Do NOT use sudo, edit shell profiles, push git changes, read .env or
credentials, or publish packages. Report back: Node version, codex
install status, doctor verdict, and whether login was needed.

以下を Codex app または CLI に貼り付けます。

Set up Inspectrum so I can review my plans with Claude. Use normal
approvals only.

Steps:
1. Run `node --version`. If < 20, stop and tell me to install Node 20+
   from https://nodejs.org first.
2. Run `claude --version`. If "command not found", run
   `npm install -g @anthropic-ai/claude-code` and verify again.
3. If `~/.inspectrum/config.toml` does not exist, create it with:

   [defaults]
   reviewers = ["claude"]

4. Run `codex mcp add inspectrum -- npx -y inspectrum@latest`
5. Run `npx -y inspectrum@latest doctor` and show me the output.
6. Pop open a Terminal window with claude already running so I can
   confirm or complete login, by executing:
     `osascript -e 'tell application "Terminal" to do script "claude"'`
   Then tell me:
   - "If claude shows its chat prompt, you're already logged in —
     close the Terminal window. Inspectrum is ready."
   - "If claude shows /login or opens a browser, complete the sign-in
     with your Claude account, then close the Terminal window.
     Inspectrum is then ready."
   (The ⚠ claude line in the doctor stays even after login because
   claude doesn't expose a status command we can detect — harmless.)

Do NOT use sudo, edit shell profiles, push git changes, read .env or
credentials, or publish packages. Report back: Node version, claude
install status, doctor verdict, and whether login was needed.

Claude Pro/Max サブスクリプションが必要です — API キーは不要です。

[defaults]
reviewers = ["codex", "gemini"]   # called in parallel
judge     = "codex"               # consolidates when >= 2 reviewers
focus     = "all"                 # correctness | completeness | risk | clarity | all

[plan_gate]                       # ExitPlanMode hook behavior
enabled          = true
max_rounds       = 2              # denials before the plan passes through
reason_max_chars = 3000           # budget for findings fed back to Claude
# reviewers      = ["codex"]      # gate-specific override of defaults.reviewers

[reviewers.codex]
effort          = "high"          # passed as -c model_reasoning_effort=high
timeout_seconds = 300             # per-reviewer override of limits.timeout_seconds
# model         = "gpt-5.6-sol"   # passed as -m; omit to inherit ~/.codex/config.toml

[reviewers.gemini]
type   = "cli"
binary = "gemini"
model  = "gemini-2.5-pro"

[reviewers.muse]
type   = "cli"
binary = "muse"                   # muse exec, prompt passed via --prompt-file
# model  = "..."                  # omit to inherit muse's own default
# effort = "high"                 # passed as --reasoning-effort

[reviewers.opencode]
type   = "cli"
binary = "opencode"               # opencode run, prompt on stdin
# model  = "google/gemini-2.5-flash"   # -m, provider/model form
# effort = "high"                 # passed as --variant

[reviewers.agy]
type   = "cli"
binary = "agy"                    # schema-constrained structured output
# model  = "..."                  # passed as --model
# effort = "high"                 # --effort; only some models accept it

[reviewers.grok]
type   = "cli"
binary = "grok"                   # confined to a read-only tool allow-list
# model  = "grok-4.6-build"       # passed as -m
# effort = "high"                 # passed as --effort

[reviewers.local]
type     = "http"
backend  = "ollama"
endpoint = "http://localhost:11434"
model    = "qwen2.5:0.5b"

[limits]
report_max_chars = 8000           # caps the stored report
timeout_seconds  = 300            # default reviewer wallclock

設定ファイルがない場合は、reviewers = ["codex"] が使用されます。API キーを使わない構成では、codex CLI は ChatGPT ログインで動作し、agy バックエンドは Google の Antigravity CLI（curl -fsSL https://antigravity.google/cli/install.sh | bash）です。個人の Google アカウントでサインインするため、提供を終了した gemini CLI の後継となる無料枠の選択肢です。実験的なバックエンドは、kimi、qwen、openrouter、ollama（ローカル、外部への通信なし）です。muse バックエンドは muse exec を --disable-shell --disable-write で制限して実行します（レビュー中のプランは信頼できない入力です）。--yolo、--disable-sandbox、--enable-shell-tool は args から指定できません。opencode バックエンドは、ツールの使用を拒否する権限セットである opencode run --agent summary を実行します（デフォルトの build エージェントは、プランのテキストからシェルコマンドを問題なく実行します）。--agent、--auto、--format は args から指定できません。agy バックエンド（Antigravity CLI）は、--json-schema で出力を制約するため、レビューは出力元でスキーマ検証されます。--effort は設定した場合にのみ送信されます（これを拒否するモデルもあります）。agy は inspectrum で制限できない唯一のバックエンドです。--sandbox と --mode plan のどちらも書き込みを防止できないことが確認されています（agy 1.1.27）。そのため、agy は信頼できるプランにのみ使用してください。制限付きの選択肢は muse、opencode、grok です。agy が設定されている場合、inspectrum doctor が警告します。grok バックエンドは、--tools の許可リスト（read_file,grep,list_dir）で制限されます。--sandbox プロファイルと --disallowed-tools は、どちらもシェルへの書き込みを防止できないことが確認されていますが、許可リストでは防止できます。--tools、--always-approve、--permission-mode は args から指定できません。gemini バックエンドは非推奨で、削除予定です。agy に移行してください。

対話型ログインを実行できないヘッドレス環境や CI ホストでは、代わりに MCP ホストの env ブロックを通じて、利用するプロバイダーの API キーを渡してください。OPENAI_API_KEY（codex）、ANTHROPIC_API_KEY（claude）、GEMINI_API_KEY（gemini）を指定します。手動設定用の JSON/TOML の例は examples/ にあります。

# Register the MCP server without the plugin:
claude mcp add --transport stdio --scope user inspectrum -- npx -y inspectrum@latest   # Claude Code
codex mcp add inspectrum -- npx -y inspectrum@latest                                   # Codex

# The automatic plan gate must use the plugin's pinned fail-open shim; do not
# register plan-gate through a mutable npm tag.

# Verify everything:
npx -y inspectrum@latest doctor

• セッションログは ~/.inspectrum/sessions/<timestamp>__<id>/ に保存されます。ログにはプラン全文と、各レビュアーの判定および検出事項を記録した Markdown が含まれます。ディレクトリのパーミッションは POSIX では 0700 です。0.1.0 より前のバージョンで書き込まれたログは、元のパーミッションが維持されます。chmod -R 700 ~/.inspectrum/sessions/ でパーミッションを変更してください。
• プランやコンテキストにシークレットを絶対に貼り付けないでください。 プランはローカルのセッションログに書き込まれ、プランとコンテキストはどちらも、アクティブなすべてのレビュアーに送信されます。
• クラウド経由の通信先：claude → Anthropic（OAuth キーチェーンまたは ANTHROPIC_API_KEY）；codex → OpenAI（ChatGPT ログインまたは OPENAI_API_KEY）；gemini → Google（個人アカウントでの CLI ログインまたは GEMINI_API_KEY）；openrouter → openrouter.ai；kimi → Moonshot AI（デバイスコードログイン：環境変数ではなく kimi login）；qwen → Alibaba Cloud；muse → CLI に保存された認証情報（muse login）；opencode → 設定したプロバイダー（opencode providers login）；agy → Google Antigravity（初回実行時のブラウザーサインイン、または ~/.gemini/antigravity-cli/settings.json に modelProvider: "gemini" を設定したうえでの GEMINI_API_KEY）；grok → xAI（Grok Build の残高）；ollama → ローカルホストのみ。endpoint を変更しない限り、外部への通信はありません。
• Codex は、一時ディレクトリ内で codex exec --ephemeral --skip-git-repo-check -s read-only … として呼び出されます。サンドボックスは読み取り専用に固定され、サンドボックスの制限を弱める引数と作業ディレクトリを上書きする引数は設定から取り除かれます。また、codex はセッションファイルを保存しません。