ai-cli-mcp 2.12.0 → 2.14.0

package/.github/workflows/publish.yml

@@ -43,22 +43,47 @@ jobs:
       - name: Verify provenance attestations
         run: npm audit signatures
 
+      - name: Capture version before release
+        id: release_before
+        run: |
+          VERSION=$(node -p 'require("./package.json").version')
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+
       - name: Release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: npx semantic-release
 
+      - name: Capture version after release
+        id: release_after
+        run: |
+          VERSION=$(node -p 'require("./package.json").version')
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Detect whether a release was published
+        id: release_status
+        run: |
+          if [ "${{ steps.release_before.outputs.version }}" != "${{ steps.release_after.outputs.version }}" ]; then
+            echo "published=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "published=false" >> "$GITHUB_OUTPUT"
+          fi
+
       - name: Install mcp-publisher
+        if: steps.release_status.outputs.published == 'true'
         run: |
           curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
 
       - name: Authenticate to MCP Registry
+        if: steps.release_status.outputs.published == 'true'
         run: ./mcp-publisher login github-oidc
 
       - name: Set version in server.json
+        if: steps.release_status.outputs.published == 'true'
         run: |
           VERSION=$(node -p "require('./package.json').version")
           jq --arg v "$VERSION" '.version = $v | .packages[0].version = $v' server.json > server.tmp && mv server.tmp server.json
 
       - name: Publish to MCP Registry
+        if: steps.release_status.outputs.published == 'true'
         run: ./mcp-publisher publish

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+# [2.14.0](https://github.com/mkXultra/ai-cli-mcp/compare/v2.13.0...v2.14.0) (2026-04-07)
+
+
+### Features
+
+* get_result・waitにcompact/verbose出力形式を追加 ([21fdff3](https://github.com/mkXultra/ai-cli-mcp/commit/21fdff3813f28327a2da94f4b5bed94b54abcd74))
+
+# [2.13.0](https://github.com/mkXultra/ai-cli-mcp/compare/v2.12.0...v2.13.0) (2026-04-07)
+
+
+### Bug Fixes
+
+* **ci:** correct release version capture shell quoting ([2986b0b](https://github.com/mkXultra/ai-cli-mcp/commit/2986b0bb0452fcf4b34491c3d832cff3b271616c))
+* **ci:** skip MCP Registry publish when no release is created ([9de4c83](https://github.com/mkXultra/ai-cli-mcp/commit/9de4c836a946b4a0028a46525b4bcfa2094032cc))
+
+
+### Features
+
+* Forge CLIを新しいAIバックエンドとして追加 ([35ae860](https://github.com/mkXultra/ai-cli-mcp/commit/35ae8604ff0a663e960fc758eee2872680aec503))
+
 # [2.12.0](https://github.com/mkXultra/ai-cli-mcp/compare/v2.11.0...v2.12.0) (2026-03-12)
 
 

package/README.ja.md

@@ -5,7 +5,7 @@
 
 > **📦 パッケージ移行のお知らせ**: 本パッケージは旧名 `@mkxultra/claude-code-mcp` から `ai-cli-mcp` に名称変更されました。これは、複数のAI CLIツールのサポート拡大を反映したものです。
 
-AI CLIツール（Claude, Codex, Gemini）をバックグラウンドプロセスとして実行し、権限処理を自動化するMCP（Model Context Protocol）サーバーです。
+AI CLIツール（Claude, Codex, Gemini, Forge）をバックグラウンドプロセスとして実行し、権限処理を自動化するMCP（Model Context Protocol）サーバーです。
 
 Cursorなどのエディタが、複雑な手順を伴う編集や操作に苦戦していることに気づいたことはありませんか？このサーバーは、強力な統合 `run` ツールを提供し、複数のAIエージェントを活用してコーディングタスクをより効果的に処理できるようにします。
 
@@ -20,10 +20,12 @@ Cursorなどのエディタが、複雑な手順を伴う編集や操作に苦
 - すべての権限確認をスキップしてClaude CLIを実行（`--dangerously-skip-permissions` を使用）
 - 自動承認モードでCodex CLIを実行（`--full-auto` を使用）
 - 自動承認モードでGemini CLIを実行（`-y` を使用）
+- Forge CLI を非対話モードで実行（`forge -C <workFolder> -p <prompt>` を使用）
 - 複数のAIモデルのサポート：
     - Claude (sonnet, sonnet[1m], opus, opusplan, haiku)
     - Codex (gpt-5.4, gpt-5.3-codex, gpt-5.2-codex, gpt-5.1-codex-mini, gpt-5.1-codex-max, など)
     - Gemini (gemini-2.5-pro, gemini-2.5-flash, gemini-3.1-pro-preview, gemini-3-pro-preview, gemini-3-flash-preview)
+    - Forge (`forge`)
 - PID追跡によるバックグラウンドプロセスの管理
 - ツールからの構造化された出力の解析と返却
 
@@ -55,7 +57,7 @@ Cursorなどのエディタが、複雑な手順を伴う編集や操作に苦
 
 - **真の非同期マルチタスク**: エージェントの実行はバックグラウンドで行われ、即座に制御が戻ります。呼び出し元のAIは実行完了を待つことなく、並行して次のタスクの実行や別のエージェントの呼び出しを行うことができます。
 - **CLI in CLI (Agent in Agent) の実現**: MCPをサポートするあらゆるIDEやCLIから、Claude CodeやCodexといった強力なCLIツールを直接呼び出せます。ホスト環境の制限を超えた、より広範で複雑なシステム操作や自動化が可能になります。
-- **モデル・プロバイダの制約からの解放**: 特定のエコシステムに縛られることなく、Claude、Codex (GPT)、Geminiの中から、タスクに最適な「最強のモデル」や「コスト効率の良いモデル」を自由に選択・組み合わせて利用できます。
+- **モデル・プロバイダの制約からの解放**: 特定のエコシステムに縛られることなく、Claude、Codex (GPT)、Gemini、Forgeの中から、タスクに最適な「最強のモデル」や「コスト効率の良いモデル」を自由に選択・組み合わせて利用できます。
 
 ## 前提条件
 
@@ -64,6 +66,7 @@ Cursorなどのエディタが、複雑な手順を伴う編集や操作に苦
 - **Claude Code**: `claude doctor` が通り、`--dangerously-skip-permissions` での実行が承認済み（一度手動で実行してログイン・承認済み）であること。
 - **Codex CLI**（オプション）: インストール済みで、ログインなどの初期設定が完了していること。
 - **Gemini CLI**（オプション）: インストール済みで、ログインなどの初期設定が完了していること。
+- **Forge CLI**（オプション）: インストール済みで、初期設定が完了していること。
 
 ## インストールと使い方
 
@@ -115,7 +118,9 @@ ai-cli models
 ai-cli run --cwd "$PWD" --model sonnet --prompt "summarize this repository"
 ai-cli ps
 ai-cli result 12345
+ai-cli result 12345 --verbose
 ai-cli wait 12345 --timeout 300
+ai-cli wait 12345 --verbose
 ai-cli kill 12345
 ai-cli cleanup
 ai-cli-mcp
@@ -182,7 +187,9 @@ ai-cli models
 ai-cli run --cwd "$PWD" --model codex-ultra --prompt "fix failing tests"
 ai-cli ps
 ai-cli wait 12345
+ai-cli wait 12345 --verbose
 ai-cli result 12345
+ai-cli result 12345 --verbose
 ai-cli cleanup
 ```
 
@@ -222,7 +229,7 @@ detached 実行された `ai-cli` の自然終了 exit code は、まだ永続
 
 ### `run`
 
-Claude CLI、Codex CLI、またはGemini CLIを使用してプロンプトを実行します。モデル名に基づいて適切なCLIが自動的に選択されます。
+Claude CLI、Codex CLI、Gemini CLI、または Forge CLI を使用してプロンプトを実行します。モデル名に基づいて適切なCLIが自動的に選択されます。
 
 **引数:**
 - `prompt` (string, 任意): AIエージェントに送信するプロンプト。`prompt` または `prompt_file` のいずれかが必須です。
@@ -233,16 +240,20 @@ Claude CLI、Codex CLI、またはGemini CLIを使用してプロンプトを実
     - Claude: `sonnet`, `sonnet[1m]`, `opus`, `opusplan`, `haiku`
     - Codex: `gpt-5.4`, `gpt-5.3-codex`, `gpt-5.2-codex`, `gpt-5.1-codex-mini`, `gpt-5.1-codex-max`, `gpt-5.2`, `gpt-5.1`, `gpt-5`
     - Gemini: `gemini-2.5-pro`, `gemini-2.5-flash`, `gemini-3.1-pro-preview`, `gemini-3-pro-preview`, `gemini-3-flash-preview`
-- `reasoning_effort` (string, 任意): Claude と Codex の推論制御。Claude では `--effort` を使います（許容値: "low", "medium", "high"）。Codex では `model_reasoning_effort` を使います（許容値: "low", "medium", "high", "xhigh"）。
-- `session_id` (string, 任意): 以前のセッションを再開するためのセッションID。対応モデル: haiku, sonnet, opus, gemini-2.5-pro, gemini-2.5-flash, gemini-3.1-pro-preview, gemini-3-pro-preview, gemini-3-flash-preview。
+    - Forge: `forge`
+- `reasoning_effort` (string, 任意): Claude と Codex の推論制御。Claude では `--effort` を使います（許容値: "low", "medium", "high"）。Codex では `model_reasoning_effort` を使います（許容値: "low", "medium", "high", "xhigh"）。Forge では `reasoning_effort` はサポートしません。
+- `session_id` (string, 任意): 以前のセッションを再開するためのセッションID。対応モデル: haiku, sonnet, opus, gemini-2.5-pro, gemini-2.5-flash, gemini-3.1-pro-preview, gemini-3-pro-preview, gemini-3-flash-preview, forge。
 
 ### `wait`
 
 複数のAIエージェントプロセスの完了を待機し、結果をまとめて返します。指定されたすべてのPIDが終了するか、タイムアウトになるまでブロックします。
 
+デフォルトでは、返される各結果項目は `get_result(verbose: false)` と同じ compact 形を使います。`pid`、`agent`、`status`、`exitCode`、`model` などの運用上必要な項目に加え、利用可能であれば `agentOutput` やトップレベルの `session_id` を含みます。`verbose: true` を指定すると、`startTime`、`workFolder`、`prompt` などの完全なメタデータや、`agentOutput.tools` のような詳細な解析結果を含む full 形を返します。
+
 **引数:**
 - `pids` (array of numbers, 必須): 待機するプロセスIDのリスト（`run` ツールから返されたもの）。
 - `timeout` (number, 任意): 最大待機時間（秒）。デフォルトは180秒（3分）です。
+- `verbose` (boolean, 任意): `true` の場合、各結果項目を full 形で返します。デフォルトは `false` です。
 
 ### `list_processes`
 
@@ -252,8 +263,11 @@ Claude CLI、Codex CLI、またはGemini CLIを使用してプロンプトを実
 
 PIDを指定して、AIエージェントプロセスの現在の出力とステータスを取得します。
 
+デフォルトでは compact 形を返します。これには `pid`、`agent`、`status`、`exitCode`、`model` などの運用上必要な項目に加え、利用可能であれば `agentOutput` やトップレベルの `session_id` を含みます。`startTime`、`workFolder`、`prompt` は含みません。`verbose: true` を指定すると、これらのメタデータや `agentOutput.tools` のような詳細な解析結果を含む full 形を返します。解析結果が得られない場合や不完全な場合は、従来どおり `stdout` / `stderr` のフォールバックを維持します。
+
 **引数:**
 - `pid` (number, 必須): `run` ツールによって返されたプロセスID。
+- `verbose` (boolean, 任意): `true` の場合、full 形で返します。デフォルトは `false` です。
 
 ### `kill_process`
 
@@ -296,6 +310,7 @@ npm run test:e2e
 - `CLAUDE_CLI_NAME`: Claude CLIのバイナリ名または絶対パスを上書き（デフォルト: `claude`）
 - `CODEX_CLI_NAME`: Codex CLIのバイナリ名または絶対パスを上書き（デフォルト: `codex`）
 - `GEMINI_CLI_NAME`: Gemini CLIのバイナリ名または絶対パスを上書き（デフォルト: `gemini`）
+- `FORGE_CLI_NAME`: Forge CLIのバイナリ名または絶対パスを上書き（デフォルト: `forge`）
 - `MCP_CLAUDE_DEBUG`: デバッグログを有効化（`true` に設定すると詳細な出力が表示されます）
 
 **CLI名の指定方法:**

package/README.md

@@ -7,7 +7,7 @@
 
 > **📦 Package Migration Notice**: This package was formerly `@mkxultra/claude-code-mcp` and has been renamed to `ai-cli-mcp` to reflect its expanded support for multiple AI CLI tools.
 
-An MCP (Model Context Protocol) server that allows running AI CLI tools (Claude, Codex, and Gemini) in background processes with automatic permission handling.
+An MCP (Model Context Protocol) server that allows running AI CLI tools (Claude, Codex, Gemini, and Forge) in background processes with automatic permission handling.
 
 Did you notice that Cursor sometimes struggles with complex, multi-step edits or operations? This server, with its powerful unified `run` tool, enables multiple AI agents to handle your coding tasks more effectively.
 
@@ -22,7 +22,8 @@ This MCP server provides tools that can be used by LLMs to interact with AI CLI
 - Run Claude CLI with all permissions bypassed (using `--dangerously-skip-permissions`)
 - Execute Codex CLI with automatic approval mode (using `--full-auto`)
 - Execute Gemini CLI with automatic approval mode (using `-y`)
-- Support multiple AI models: Claude (sonnet, sonnet[1m], opus, opusplan, haiku), Codex (gpt-5.4, gpt-5.3-codex, gpt-5.2-codex, gpt-5.1-codex-mini, gpt-5.1-codex-max, gpt-5.2, gpt-5.1, gpt-5.1-codex, gpt-5-codex, gpt-5-codex-mini, gpt-5), and Gemini (gemini-2.5-pro, gemini-2.5-flash, gemini-3.1-pro-preview, gemini-3-pro-preview, gemini-3-flash-preview)
+- Execute Forge CLI in non-interactive mode (using `forge -C <workFolder> -p <prompt>`)
+- Support multiple AI models: Claude (sonnet, sonnet[1m], opus, opusplan, haiku), Codex (gpt-5.4, gpt-5.3-codex, gpt-5.2-codex, gpt-5.1-codex-mini, gpt-5.1-codex-max, gpt-5.2, gpt-5.1, gpt-5.1-codex, gpt-5-codex, gpt-5-codex-mini, gpt-5), Gemini (gemini-2.5-pro, gemini-2.5-flash, gemini-3.1-pro-preview, gemini-3-pro-preview, gemini-3-flash-preview), and Forge (`forge`)
 - Manage background processes with PID tracking
 - Parse and return structured outputs from both tools
 
@@ -54,7 +55,7 @@ You can reuse heavy context (like large codebases) using session IDs to save cos
 
 - **True Async Multitasking**: Agent execution happens in the background, returning control immediately. The calling AI can proceed with the next task or invoke another agent without waiting for completion.
 - **CLI in CLI (Agent in Agent)**: Directly invoke powerful CLI tools like Claude Code or Codex from any MCP-supported IDE or CLI. This enables broader, more complex system operations and automation beyond host environment limitations.
-- **Freedom from Model/Provider Constraints**: Freely select and combine the "strongest" or "most cost-effective" models from Claude, Codex (GPT), and Gemini without being tied to a specific ecosystem.
+- **Freedom from Model/Provider Constraints**: Freely select and combine the "strongest" or "most cost-effective" models from Claude, Codex (GPT), Gemini, and Forge without being tied to a specific ecosystem.
 
 ## Prerequisites
 
@@ -63,6 +64,7 @@ The only prerequisite is that the AI CLI tools you want to use are locally insta
 - **Claude Code**: `claude doctor` passes, and execution with `--dangerously-skip-permissions` is approved (you must run it manually once to login and accept terms).
 - **Codex CLI** (Optional): Installed and initial setup (login etc.) completed.
 - **Gemini CLI** (Optional): Installed and initial setup (login etc.) completed.
+- **Forge CLI** (Optional): Installed and initial setup completed.
 
 ## Installation & Usage
 
@@ -114,7 +116,9 @@ ai-cli models
 ai-cli run --cwd "$PWD" --model sonnet --prompt "summarize this repository"
 ai-cli ps
 ai-cli result 12345
+ai-cli result 12345 --verbose
 ai-cli wait 12345 --timeout 300
+ai-cli wait 12345 --verbose
 ai-cli kill 12345
 ai-cli cleanup
 ai-cli-mcp
@@ -181,7 +185,9 @@ ai-cli models
 ai-cli run --cwd "$PWD" --model codex-ultra --prompt "fix failing tests"
 ai-cli ps
 ai-cli wait 12345
+ai-cli wait 12345 --verbose
 ai-cli result 12345
+ai-cli result 12345 --verbose
 ai-cli cleanup
 ```
 
@@ -221,7 +227,7 @@ This server exposes the following tools:
 
 ### `run`
 
-Executes a prompt using Claude CLI, Codex CLI, or Gemini CLI. The appropriate CLI is automatically selected based on the model name.
+Executes a prompt using Claude CLI, Codex CLI, Gemini CLI, or Forge CLI. The appropriate CLI is automatically selected based on the model name.
 
 **Arguments:**
 - `prompt` (string, optional): The prompt to send to the AI agent. Either `prompt` or `prompt_file` is required.
@@ -232,16 +238,20 @@ Executes a prompt using Claude CLI, Codex CLI, or Gemini CLI. The appropriate CL
 - Claude: `sonnet`, `sonnet[1m]`, `opus`, `opusplan`, `haiku`
 - Codex: `gpt-5.4`, `gpt-5.3-codex`, `gpt-5.2-codex`, `gpt-5.1-codex-mini`, `gpt-5.1-codex-max`, `gpt-5.2`, `gpt-5.1`, `gpt-5`
 - Gemini: `gemini-2.5-pro`, `gemini-2.5-flash`, `gemini-3.1-pro-preview`, `gemini-3-pro-preview`, `gemini-3-flash-preview`
-- `reasoning_effort` (string, optional): Reasoning control for Claude and Codex. Claude uses `--effort` (allowed: "low", "medium", "high"). Codex uses `model_reasoning_effort` (allowed: "low", "medium", "high", "xhigh").
-- `session_id` (string, optional): Optional session ID to resume a previous session. Supported for: haiku, sonnet, opus, gemini-2.5-pro, gemini-2.5-flash, gemini-3.1-pro-preview, gemini-3-pro-preview, gemini-3-flash-preview.
+- Forge: `forge`
+- `reasoning_effort` (string, optional): Reasoning control for Claude and Codex. Claude uses `--effort` (allowed: "low", "medium", "high"). Codex uses `model_reasoning_effort` (allowed: "low", "medium", "high", "xhigh"). Forge does not support `reasoning_effort`.
+- `session_id` (string, optional): Optional session ID to resume a previous session. Supported for: haiku, sonnet, opus, gemini-2.5-pro, gemini-2.5-flash, gemini-3.1-pro-preview, gemini-3-pro-preview, gemini-3-flash-preview, forge.
 
 ### `wait`
 
 Waits for multiple AI agent processes to complete and returns their combined results. Blocks until all specified PIDs finish or a timeout occurs.
 
+By default, each returned result item uses the compact shape shared with `get_result(verbose: false)`: operational fields such as `pid`, `agent`, `status`, `exitCode`, `model`, parsed output such as `agentOutput`, and top-level `session_id` when available. Set `verbose: true` to include full metadata like `startTime`, `workFolder`, `prompt`, and detailed parsed output such as `agentOutput.tools`.
+
 **Arguments:**
 - `pids` (array of numbers, required): List of process IDs to wait for (returned by the `run` tool).
 - `timeout` (number, optional): Maximum wait time in seconds. Defaults to 180 (3 minutes).
+- `verbose` (boolean, optional): If `true`, each result item uses the full result shape. Defaults to `false`.
 
 ### `list_processes`
 
@@ -251,8 +261,11 @@ Lists all running and completed AI agent processes with their status, PID, and b
 
 Gets the current output and status of an AI agent process by PID.
 
+By default, this returns the compact result shape: operational fields such as `pid`, `agent`, `status`, `exitCode`, `model`, parsed output such as `agentOutput`, and top-level `session_id` when available. It omits metadata fields like `startTime`, `workFolder`, and `prompt`. Set `verbose: true` to return the full result shape including those metadata fields and detailed parsed output such as `agentOutput.tools`. If parsed output is unavailable or incomplete, the raw `stdout`/`stderr` fallback is preserved.
+
 **Arguments:**
 - `pid` (number, required): The process ID returned by the `run` tool.
+- `verbose` (boolean, optional): If `true`, returns the full result shape. Defaults to `false`.
 
 ### `kill_process`
 
@@ -281,6 +294,7 @@ Normally not required, but useful for customizing CLI paths or debugging.
 - `CLAUDE_CLI_NAME`: Override the Claude CLI binary name or provide an absolute path (default: `claude`)
 - `CODEX_CLI_NAME`: Override the Codex CLI binary name or provide an absolute path (default: `codex`)
 - `GEMINI_CLI_NAME`: Override the Gemini CLI binary name or provide an absolute path (default: `gemini`)
+- `FORGE_CLI_NAME`: Override the Forge CLI binary name or provide an absolute path (default: `forge`)
 - `MCP_CLAUDE_DEBUG`: Enable debug logging (set to `true` for verbose output)
 
 **CLI Name Specification:**

package/dist/__tests__/app-cli.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it, vi } from 'vitest';
-import { CLI_HELP_TEXT, DOCTOR_HELP_TEXT, MODELS_HELP_TEXT, RUN_HELP_TEXT, WAIT_HELP_TEXT, runCli, } from '../app/cli.js';
+import { CLI_HELP_TEXT, DOCTOR_HELP_TEXT, MODELS_HELP_TEXT, RESULT_HELP_TEXT, RUN_HELP_TEXT, WAIT_HELP_TEXT, runCli, } from '../app/cli.js';
 describe('ai-cli app', () => {
     it('prints help and exits successfully when no subcommand is provided', async () => {
         const stdout = vi.fn();
@@ -108,9 +108,21 @@ describe('ai-cli app', () => {
             waitForProcesses,
         });
         expect(exitCode).toBe(0);
-        expect(waitForProcesses).toHaveBeenCalledWith([123, 456], 5);
+        expect(waitForProcesses).toHaveBeenCalledWith([123, 456], 5, false);
         expect(stdout).toHaveBeenCalledWith(expect.stringContaining('"status": "completed"'));
     });
+    it('passes verbose through to wait', async () => {
+        const stdout = vi.fn();
+        const stderr = vi.fn();
+        const waitForProcesses = vi.fn().mockResolvedValue([{ pid: 123, status: 'completed' }]);
+        const exitCode = await runCli(['wait', '123', '--verbose'], {
+            stdout,
+            stderr,
+            waitForProcesses,
+        });
+        expect(exitCode).toBe(0);
+        expect(waitForProcesses).toHaveBeenCalledWith([123], undefined, true);
+    });
     it('rejects invalid wait timeout values', async () => {
         const stdout = vi.fn();
         const stderr = vi.fn();
@@ -172,6 +184,7 @@ describe('ai-cli app', () => {
         expect(stdout).toHaveBeenCalledWith(expect.stringContaining('"aliases"'));
         expect(stdout).toHaveBeenCalledWith(expect.stringContaining('"claude-ultra"'));
         expect(stdout).toHaveBeenCalledWith(expect.stringContaining('"gpt-5.4"'));
+        expect(stdout).toHaveBeenCalledWith(expect.stringContaining('"forge"'));
         expect(stderr).not.toHaveBeenCalled();
     });
     it('prints doctor status as structured json', async () => {
@@ -196,6 +209,12 @@ describe('ai-cli app', () => {
                 available: true,
                 lookup: 'path',
             },
+            forge: {
+                configuredCommand: 'forge',
+                resolvedPath: '/tmp/bin/forge',
+                available: true,
+                lookup: 'path',
+            },
         });
         const exitCode = await runCli(['doctor'], { stdout, stderr, getDoctorStatus });
         expect(exitCode).toBe(0);
@@ -221,6 +240,17 @@ describe('ai-cli app', () => {
         expect(stdout).toHaveBeenCalledWith(expect.stringContaining('claude-ultra'));
         expect(stdout).toHaveBeenCalledWith(expect.stringContaining('gpt-5.2-codex'));
         expect(stdout).toHaveBeenCalledWith(expect.stringContaining('gemini-2.5-pro'));
+        expect(stdout).toHaveBeenCalledWith(expect.stringContaining('forge'));
+        expect(stderr).not.toHaveBeenCalled();
+    });
+    it('prints detailed help for result --help', async () => {
+        const stdout = vi.fn();
+        const stderr = vi.fn();
+        const exitCode = await runCli(['result', '--help'], { stdout, stderr });
+        expect(exitCode).toBe(0);
+        expect(stdout).toHaveBeenCalledWith(RESULT_HELP_TEXT);
+        expect(stdout).toHaveBeenCalledWith(expect.stringContaining('compact result shape'));
+        expect(stdout).toHaveBeenCalledWith(expect.stringContaining('--verbose'));
         expect(stderr).not.toHaveBeenCalled();
     });
     it('prints detailed help for wait --help', async () => {
@@ -229,6 +259,8 @@ describe('ai-cli app', () => {
         const exitCode = await runCli(['wait', '--help'], { stdout, stderr });
         expect(exitCode).toBe(0);
         expect(stdout).toHaveBeenCalledWith(WAIT_HELP_TEXT);
+        expect(stdout).toHaveBeenCalledWith(expect.stringContaining('compact shape'));
+        expect(stdout).toHaveBeenCalledWith(expect.stringContaining('--verbose'));
         expect(stderr).not.toHaveBeenCalled();
     });
     it('prints detailed help for models --help', async () => {

package/dist/__tests__/cli-bin-smoke.test.js

@@ -25,6 +25,7 @@ describe('ai-cli entrypoint smoke', () => {
         writeExecutable(fakeBinDir, 'claude');
         writeExecutable(fakeBinDir, 'codex');
         writeExecutable(fakeBinDir, 'gemini');
+        writeExecutable(fakeBinDir, 'forge');
         const output = execFileSync('node', ['--import', 'tsx', 'src/bin/ai-cli.ts', 'doctor'], {
             cwd: process.cwd(),
             encoding: 'utf8',
@@ -34,11 +35,13 @@ describe('ai-cli entrypoint smoke', () => {
                 CLAUDE_CLI_NAME: 'claude',
                 CODEX_CLI_NAME: 'codex',
                 GEMINI_CLI_NAME: 'gemini',
+                FORGE_CLI_NAME: 'forge',
             },
         });
         expect(output).toContain('"claude"');
         expect(output).toContain('"codex"');
         expect(output).toContain('"gemini"');
+        expect(output).toContain('"forge"');
         expect(output).toContain('"available": true');
     });
     it('prints run help for the ai-cli entrypoint', () => {
@@ -50,5 +53,6 @@ describe('ai-cli entrypoint smoke', () => {
         expect(output).toContain('Usage: ai-cli run --cwd <path> [options]');
         expect(output).toContain('--model <model>');
         expect(output).toContain('claude-ultra');
+        expect(output).toContain('forge');
     });
 });

package/dist/__tests__/cli-builder.test.js

@@ -14,6 +14,7 @@ const DEFAULT_CLI_PATHS = {
     claude: '/usr/bin/claude',
     codex: '/usr/bin/codex',
     gemini: '/usr/bin/gemini',
+    forge: '/usr/bin/forge',
 };
 describe('cli-builder', () => {
     beforeEach(() => {
@@ -70,6 +71,9 @@ describe('cli-builder', () => {
         it('should throw for unsupported model families', () => {
             expect(() => getReasoningEffort('gemini-2.5-pro', 'high')).toThrow('reasoning_effort is only supported for Claude and Codex models.');
         });
+        it('should reject reasoning_effort for forge explicitly', () => {
+            expect(() => getReasoningEffort('forge', 'high')).toThrow('reasoning_effort is not supported for forge.');
+        });
     });
     describe('buildCliCommand', () => {
         describe('validation', () => {
@@ -322,5 +326,38 @@ describe('cli-builder', () => {
                 expect(cmd.resolvedModel).toBe('gemini-3.1-pro-preview');
             });
         });
+        describe('forge agent', () => {
+            it('should build forge command without model flags', () => {
+                const cmd = buildCliCommand({
+                    prompt: 'test',
+                    workFolder: '/tmp',
+                    model: 'forge',
+                    cliPaths: DEFAULT_CLI_PATHS,
+                });
+                expect(cmd.agent).toBe('forge');
+                expect(cmd.cliPath).toBe('/usr/bin/forge');
+                expect(cmd.resolvedModel).toBe('forge');
+                expect(cmd.args).toEqual(['-C', '/tmp', '-p', 'test']);
+            });
+            it('should map session_id to --conversation-id for forge', () => {
+                const cmd = buildCliCommand({
+                    prompt: 'test',
+                    workFolder: '/tmp',
+                    model: 'forge',
+                    session_id: 'forge-conv-123',
+                    cliPaths: DEFAULT_CLI_PATHS,
+                });
+                expect(cmd.args).toEqual(['-C', '/tmp', '--conversation-id', 'forge-conv-123', '-p', 'test']);
+            });
+            it('should reject reasoning_effort for forge in command building', () => {
+                expect(() => buildCliCommand({
+                    prompt: 'test',
+                    workFolder: '/tmp',
+                    model: 'forge',
+                    reasoning_effort: 'high',
+                    cliPaths: DEFAULT_CLI_PATHS,
+                })).toThrow('reasoning_effort is not supported for forge.');
+            });
+        });
     });
 });