@ai-agent-forge/agent-forge 0.86.6 → 0.87.0

package/dist/cli/args.js

@@ -3,6 +3,7 @@
  */
 import chalk from "chalk";
 import { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR, ENV_SESSION_DIR } from "../config.js";
+import { t } from "../core/i18n/index.js";
 // TRACE_KINDS_V1 is a value import, but observability-types.ts has no runtime
 // edges (its two imports are type-only), so no import cycle can form here.
 import { TRACE_KINDS_V1 } from "../plugins/observability-types.js";
@@ -28,25 +29,28 @@ export function normalizeSessionName(value) {
 function parseBoundedPluginId(args, index, result, option, values) {
     const raw = args[index + 1];
     if (raw === undefined || raw.startsWith("-")) {
-        result.diagnostics.push({ type: "error", message: `${option} requires a plugin id` });
+        result.diagnostics.push({ type: "error", message: t("{option} requires a plugin id", { option }) });
         return index;
     }
     const value = raw.trim();
     if (value.length === 0) {
-        result.diagnostics.push({ type: "error", message: `${option} requires a non-empty plugin id` });
+        result.diagnostics.push({ type: "error", message: t("{option} requires a non-empty plugin id", { option }) });
         return index + 1;
     }
     if (value.length > MAX_PLUGIN_CLI_ID_CHARS) {
         result.diagnostics.push({
             type: "error",
-            message: `${option} plugin id must be at most ${MAX_PLUGIN_CLI_ID_CHARS} characters`,
+            message: t("{option} plugin id must be at most {max} characters", {
+                option,
+                max: MAX_PLUGIN_CLI_ID_CHARS,
+            }),
         });
         return index + 1;
     }
     if (values.length >= MAX_PLUGIN_CLI_IDS) {
         result.diagnostics.push({
             type: "error",
-            message: `${option} accepts at most ${MAX_PLUGIN_CLI_IDS} plugin ids`,
+            message: t("{option} accepts at most {max} plugin ids", { option, max: MAX_PLUGIN_CLI_IDS }),
         });
         return index + 1;
     }
@@ -56,18 +60,21 @@ function parseBoundedPluginId(args, index, result, option, values) {
 function parsePluginProfileValue(args, index, result, rawValue) {
     const raw = rawValue ?? args[index + 1];
     if (raw === undefined || raw.startsWith("-")) {
-        result.diagnostics.push({ type: "error", message: "--plugin-profile requires a profile id" });
+        result.diagnostics.push({ type: "error", message: t("--plugin-profile requires a profile id") });
         return rawValue === undefined ? index : index;
     }
     const value = raw.trim();
     if (value.length === 0) {
-        result.diagnostics.push({ type: "error", message: "--plugin-profile requires a non-empty profile id" });
+        result.diagnostics.push({
+            type: "error",
+            message: t("--plugin-profile requires a non-empty profile id"),
+        });
         return rawValue === undefined ? index + 1 : index;
     }
     if (value.length > MAX_PLUGIN_CLI_ID_CHARS) {
         result.diagnostics.push({
             type: "error",
-            message: `--plugin-profile id must be at most ${MAX_PLUGIN_CLI_ID_CHARS} characters`,
+            message: t("--plugin-profile id must be at most {max} characters", { max: MAX_PLUGIN_CLI_ID_CHARS }),
         });
         return rawValue === undefined ? index + 1 : index;
     }
@@ -102,14 +109,14 @@ export function parseArgs(args) {
         else if (arg === "--mode") {
             const mode = args[i + 1];
             if (mode === undefined || mode.startsWith("-")) {
-                result.diagnostics.push({ type: "error", message: "--mode requires text, json, or rpc" });
+                result.diagnostics.push({ type: "error", message: t("--mode requires text, json, or rpc") });
                 continue;
             }
             i++;
             if (mode !== "text" && mode !== "json" && mode !== "rpc") {
                 result.diagnostics.push({
                     type: "error",
-                    message: `Invalid mode "${mode}". Valid values: text, json, rpc`,
+                    message: t('Invalid mode "{mode}". Valid values: text, json, rpc', { mode }),
                 });
                 continue;
             }
@@ -142,7 +149,7 @@ export function parseArgs(args) {
                 result.name = args[++i];
             }
             else {
-                result.diagnostics.push({ type: "error", message: "--name requires a value" });
+                result.diagnostics.push({ type: "error", message: t("--name requires a value") });
             }
         }
         else if (arg === "--no-session") {
@@ -170,7 +177,7 @@ export function parseArgs(args) {
                 i++;
             }
             else {
-                result.diagnostics.push({ type: "error", message: "--suite requires a suite id" });
+                result.diagnostics.push({ type: "error", message: t("--suite requires a suite id") });
             }
         }
         else if (arg === "--suite-create") {
@@ -180,7 +187,7 @@ export function parseArgs(args) {
                 i++;
             }
             else {
-                result.diagnostics.push({ type: "error", message: "--suite-create requires a suite id" });
+                result.diagnostics.push({ type: "error", message: t("--suite-create requires a suite id") });
             }
         }
         else if (arg === "--clone-from") {
@@ -190,7 +197,7 @@ export function parseArgs(args) {
                 i++;
             }
             else {
-                result.diagnostics.push({ type: "error", message: "--clone-from requires a suite id" });
+                result.diagnostics.push({ type: "error", message: t("--clone-from requires a suite id") });
             }
         }
         else if (arg === "--suite-delete") {
@@ -200,7 +207,7 @@ export function parseArgs(args) {
                 i++;
             }
             else {
-                result.diagnostics.push({ type: "error", message: "--suite-delete requires a suite id" });
+                result.diagnostics.push({ type: "error", message: t("--suite-delete requires a suite id") });
             }
         }
         else if (arg === "--suite-reset") {
@@ -210,7 +217,7 @@ export function parseArgs(args) {
                 i++;
             }
             else {
-                result.diagnostics.push({ type: "error", message: "--suite-reset requires a suite id" });
+                result.diagnostics.push({ type: "error", message: t("--suite-reset requires a suite id") });
             }
         }
         else if (arg === "--serve") {
@@ -221,7 +228,10 @@ export function parseArgs(args) {
                 i++;
             }
             else {
-                result.diagnostics.push({ type: "error", message: "--serve requires a valid TCP port (0-65535)" });
+                result.diagnostics.push({
+                    type: "error",
+                    message: t("--serve requires a valid TCP port (0-65535)"),
+                });
                 if (raw !== undefined)
                     i++;
             }
@@ -232,7 +242,10 @@ export function parseArgs(args) {
         else if (arg === "--serve-workspace-root") {
             const dir = args[i + 1];
             if (dir === undefined || dir.startsWith("-")) {
-                result.diagnostics.push({ type: "error", message: "--serve-workspace-root requires a directory" });
+                result.diagnostics.push({
+                    type: "error",
+                    message: t("--serve-workspace-root requires a directory"),
+                });
             }
             else {
                 result.serveWorkspaceRoots = result.serveWorkspaceRoots ?? [];
@@ -269,7 +282,10 @@ export function parseArgs(args) {
             else {
                 result.diagnostics.push({
                     type: "warning",
-                    message: `Invalid thinking level "${level}". Valid values: ${VALID_THINKING_LEVELS.join(", ")}`,
+                    message: t('Invalid thinking level "{level}". Valid values: {levels}', {
+                        level,
+                        levels: VALID_THINKING_LEVELS.join(", "),
+                    }),
                 });
             }
         }
@@ -302,7 +318,10 @@ export function parseArgs(args) {
         else if (arg === "--trace-kind") {
             const raw = args[i + 1];
             if (raw === undefined || raw.startsWith("-")) {
-                result.diagnostics.push({ type: "error", message: "--trace-kind requires a comma-separated kind list" });
+                result.diagnostics.push({
+                    type: "error",
+                    message: t("--trace-kind requires a comma-separated kind list"),
+                });
             }
             else {
                 i++;
@@ -312,12 +331,18 @@ export function parseArgs(args) {
                     .filter((kind) => kind.length > 0);
                 const invalid = kinds.filter((kind) => !isValidTraceKind(kind));
                 if (kinds.length === 0) {
-                    result.diagnostics.push({ type: "error", message: "--trace-kind requires at least one trace kind" });
+                    result.diagnostics.push({
+                        type: "error",
+                        message: t("--trace-kind requires at least one trace kind"),
+                    });
                 }
                 else if (invalid.length > 0) {
                     result.diagnostics.push({
                         type: "error",
-                        message: `Invalid trace kind(s) "${invalid.join(", ")}". Valid values: ${TRACE_KINDS_V1.join(", ")}`,
+                        message: t('Invalid trace kind(s) "{kinds}". Valid values: {valid}', {
+                            kinds: invalid.join(", "),
+                            valid: TRACE_KINDS_V1.join(", "),
+                        }),
                     });
                 }
                 else {
@@ -328,7 +353,10 @@ export function parseArgs(args) {
         else if (arg === "--trace-limit") {
             const raw = args[i + 1];
             if (raw === undefined || raw.startsWith("-")) {
-                result.diagnostics.push({ type: "error", message: "--trace-limit requires a positive integer" });
+                result.diagnostics.push({
+                    type: "error",
+                    message: t("--trace-limit requires a positive integer"),
+                });
             }
             else {
                 i++;
@@ -339,7 +367,7 @@ export function parseArgs(args) {
                 else {
                     result.diagnostics.push({
                         type: "error",
-                        message: `Invalid trace limit "${raw}". Expected a positive integer`,
+                        message: t('Invalid trace limit "{limit}". Expected a positive integer', { limit: raw }),
                     });
                 }
             }
@@ -353,13 +381,16 @@ export function parseArgs(args) {
         else if (arg === "--log-level") {
             const level = args[i + 1];
             if (level === undefined || level.startsWith("-")) {
-                result.diagnostics.push({ type: "error", message: "--log-level requires a level" });
+                result.diagnostics.push({ type: "error", message: t("--log-level requires a level") });
             }
             else if (!isValidHostLogLevel(level)) {
                 i++;
                 result.diagnostics.push({
                     type: "error",
-                    message: `Invalid log level "${level}". Valid values: ${VALID_LOG_LEVELS.join(", ")}`,
+                    message: t('Invalid log level "{level}". Valid values: {levels}', {
+                        level,
+                        levels: VALID_LOG_LEVELS.join(", "),
+                    }),
                 });
             }
             else {
@@ -378,10 +409,10 @@ export function parseArgs(args) {
             if (arg === "--plugin-scope")
                 i++;
             if (raw !== "global" && raw !== "project") {
-                result.diagnostics.push({ type: "error", message: "--plugin-scope must be global or project" });
+                result.diagnostics.push({ type: "error", message: t("--plugin-scope must be global or project") });
             }
             else if (result.pluginSelectionScope !== undefined) {
-                result.diagnostics.push({ type: "error", message: "--plugin-scope may be specified only once" });
+                result.diagnostics.push({ type: "error", message: t("--plugin-scope may be specified only once") });
             }
             else {
                 result.pluginSelectionScope = raw;
@@ -395,18 +426,24 @@ export function parseArgs(args) {
             result.plugins = result.plugins ?? [];
             const value = arg.slice("--plugin=".length).trim();
             if (value.length === 0) {
-                result.diagnostics.push({ type: "error", message: "--plugin requires a non-empty plugin id" });
+                result.diagnostics.push({
+                    type: "error",
+                    message: t("{option} requires a non-empty plugin id", { option: "--plugin" }),
+                });
             }
             else if (value.length > MAX_PLUGIN_CLI_ID_CHARS) {
                 result.diagnostics.push({
                     type: "error",
-                    message: `--plugin plugin id must be at most ${MAX_PLUGIN_CLI_ID_CHARS} characters`,
+                    message: t("{option} plugin id must be at most {max} characters", {
+                        option: "--plugin",
+                        max: MAX_PLUGIN_CLI_ID_CHARS,
+                    }),
                 });
             }
             else if (result.plugins.length >= MAX_PLUGIN_CLI_IDS) {
                 result.diagnostics.push({
                     type: "error",
-                    message: `--plugin accepts at most ${MAX_PLUGIN_CLI_IDS} plugin ids`,
+                    message: t("{option} accepts at most {max} plugin ids", { option: "--plugin", max: MAX_PLUGIN_CLI_IDS }),
                 });
             }
             else {
@@ -421,18 +458,27 @@ export function parseArgs(args) {
             result.disabledPlugins = result.disabledPlugins ?? [];
             const value = arg.slice("--disable-plugin=".length).trim();
             if (value.length === 0) {
-                result.diagnostics.push({ type: "error", message: "--disable-plugin requires a non-empty plugin id" });
+                result.diagnostics.push({
+                    type: "error",
+                    message: t("{option} requires a non-empty plugin id", { option: "--disable-plugin" }),
+                });
             }
             else if (value.length > MAX_PLUGIN_CLI_ID_CHARS) {
                 result.diagnostics.push({
                     type: "error",
-                    message: `--disable-plugin plugin id must be at most ${MAX_PLUGIN_CLI_ID_CHARS} characters`,
+                    message: t("{option} plugin id must be at most {max} characters", {
+                        option: "--disable-plugin",
+                        max: MAX_PLUGIN_CLI_ID_CHARS,
+                    }),
                 });
             }
             else if (result.disabledPlugins.length >= MAX_PLUGIN_CLI_IDS) {
                 result.diagnostics.push({
                     type: "error",
-                    message: `--disable-plugin accepts at most ${MAX_PLUGIN_CLI_IDS} plugin ids`,
+                    message: t("{option} accepts at most {max} plugin ids", {
+                        option: "--disable-plugin",
+                        max: MAX_PLUGIN_CLI_IDS,
+                    }),
                 });
             }
             else {
@@ -454,7 +500,7 @@ export function parseArgs(args) {
         else if (arg === "--use-theme") {
             const themeName = args[i + 1];
             if (themeName === undefined || themeName.startsWith("-")) {
-                result.diagnostics.push({ type: "error", message: "--use-theme requires a theme name" });
+                result.diagnostics.push({ type: "error", message: t("--use-theme requires a theme name") });
             }
             else {
                 result.useTheme = themeName;
@@ -489,13 +535,13 @@ export function parseArgs(args) {
                 i++;
             }
             else if (mode === undefined || mode.startsWith("-")) {
-                result.diagnostics.push({ type: "error", message: "--tui-mode requires regular or fullscreen" });
+                result.diagnostics.push({ type: "error", message: t("--tui-mode requires regular or fullscreen") });
             }
             else {
                 i++;
                 result.diagnostics.push({
                     type: "error",
-                    message: `Invalid TUI mode "${mode}". Valid values: regular, fullscreen`,
+                    message: t('Invalid TUI mode "{mode}". Valid values: regular, fullscreen', { mode }),
                 });
             }
         }
@@ -524,202 +570,202 @@ export function parseArgs(args) {
     return result;
 }
 export function printHelp() {
-    console.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools
+    console.log(`${chalk.bold(APP_NAME)} - ${t("AI coding assistant with read, bash, edit, write tools")}
 
-${chalk.bold("Usage:")}
+${chalk.bold(t("Usage:"))}
   ${APP_NAME} [options] [--] [@files...] [messages...]
 
-${chalk.bold("Commands:")}
-  ${APP_NAME} install <source> [-l]     Install extension source and add to settings
-  ${APP_NAME} remove <source> [-l]      Remove extension source from settings
-  ${APP_NAME} uninstall <source> [-l]   Alias for remove
-  ${APP_NAME} update [source|self|agent-forge]   Update Agent Forge, extensions, or model catalogs
-  ${APP_NAME} list                      List installed extensions from settings
-  ${APP_NAME} config [-l]               Open TUI to enable/disable package resources (Tab switches scope)
-  ${APP_NAME} auth <command>            Print credentials or check provider readiness
-  ${APP_NAME} <command> --help          Show help for install/remove/uninstall/update/list/config/auth
+${chalk.bold(t("Commands:"))}
+  ${APP_NAME} install <source> [-l]     ${t("Install extension source and add to settings")}
+  ${APP_NAME} remove <source> [-l]      ${t("Remove extension source from settings")}
+  ${APP_NAME} uninstall <source> [-l]   ${t("Alias for remove")}
+  ${APP_NAME} update [source|self|agent-forge]   ${t("Update Agent Forge, extensions, or model catalogs")}
+  ${APP_NAME} list                      ${t("List installed extensions from settings")}
+  ${APP_NAME} config [-l]               ${t("Open TUI to enable/disable package resources (Tab switches scope)")}
+  ${APP_NAME} auth <command>            ${t("Print credentials or check provider readiness")}
+  ${APP_NAME} <command> --help          ${t("Show help for install/remove/uninstall/update/list/config/auth")}
 
-${chalk.bold("Options:")}
-  --provider <name>              Provider name (default: google)
-  --model <pattern>              Model pattern or ID (supports "provider/id" and optional ":<thinking>")
-  --api-key <key>                API key (defaults to env vars)
-  --system-prompt <text>         System prompt (default: coding assistant prompt)
-  --append-system-prompt <text>  Append text or file contents to the system prompt (can be used multiple times)
-  --mode <mode>                  Output mode: text (default), json, or rpc
-  --print, -p                    Non-interactive mode: process prompt and exit
-  --continue, -c                 Continue previous session
-  --resume, -r                   Select a session to resume
-  --session <path|id>            Use specific session file or partial UUID
-  --session-id <id>              Use exact project session ID, creating it if missing
-  --fork <path|id>               Fork specific session file or partial UUID into a new session
-  --session-dir <dir>            Directory for session storage and lookup
-  --suite <id>                   Suite (方案) for this run: assistant (default) or coding; new sessions only
-  --suite-create <id>            Create a user suite workspace and exit; add --clone-from <id> to copy one
-  --suite-delete <id>            Delete a user suite workspace (active session references refuse) and exit
-  --suite-reset <id>             Reset a builtin suite to factory contents (shows a diff) and exit
-  --serve <port>                 (Experimental, local trust only) Serve the coding-agent session runtime over the WebSocket gateway (default: 127.0.0.1; HTTP surface: /healthz plus token-protected artifact reads) and exit on SIGINT/SIGTERM
-                                 Durable journal: <agentDir>/remote-server-journal.jsonl (never the process cwd)
-  --serve-workspace-root <dir>   Opt-in --serve boundary: remote creates must run inside one of these roots (repeatable); without it any local directory is allowed
-  --subagent-runner              (Experimental) Run as a headless subagent runner: serve the subagent-task protocol on stdio for a parent session's runner pool (D-045)
-  --no-session                   Don't save session (ephemeral)
-  --name, -n <name>              Set session display name
-  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling
-                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching
-  --no-tools, -nt                Disable all tools by default (built-in and plugin)
-  --no-builtin-tools, -nbt       Disable built-in tools by default but keep plugin/custom tools enabled
-  --tools, -t <tools>            Comma-separated allowlist of tool names to enable
-                                 Applies to built-in, plugin, and custom tools
-  --exclude-tools, -xt <tools>   Comma-separated denylist of tool names to disable
-                                 Applies to built-in, plugin, and custom tools
-  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh, max
-  --no-plugins, -np               Disable capability plugin discovery (D-028 escape hatch)
-  --no-trace                      Disable session trace collection (no .trace.jsonl file is written)
-  --log-level <level>             Host log level: debug, info (default), warn, error
-  --plugin-profile <id>            Select a builtin capability plugin profile for this run
-  --plugin <id>                    Select a plugin within the profile (repeatable)
-  --disable-plugin <id>            Disable a plugin within the profile (repeatable)
-  --plugin-scope <scope>           Read the explicit selection from global or project storage
-  plugin catalog list             List installed/available ecosystem plugins (independent namespace)
-  --skill <path>                 Load a skill file or directory (can be used multiple times)
-  --no-skills, -ns               Disable skills discovery and loading
-  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)
-  --no-prompt-templates, -np     Disable prompt template discovery and loading
-  --theme <path>                 Load a theme file or directory (can be used multiple times)
-  --use-theme <name[/name]>      Set the initial interactive theme for this run
-  --no-themes                    Disable theme discovery and loading
-  --no-context-files, -nc        Disable AGENTS.md and CLAUDE.md discovery and loading
-  --export <file>                Export session file to HTML and exit
-  --trace <session>              View a session trace file as a text timeline and exit; <session> is a session id/prefix or trace/session file path, omit it for the most recent session
-  --trace-json                   With --trace, output the structured trace records as JSON instead of the text timeline
-  --trace-kind <k1,k2>           With --trace, show only records of these kinds (comma-separated); valid kinds: ${TRACE_KINDS_V1.join(", ")}
-  --trace-limit <n>              With --trace, show only the last N records (positive integer)
-  --list-models [search]         List available models (with optional fuzzy search)
-  --verbose                      Force verbose startup (overrides quietStartup setting)
-  --tui-mode <mode>              TUI mode: regular (default) or fullscreen
-  --offline                      Disable startup network operations (same as AGENT_FORGE_OFFLINE=1)
-  --                             End option parsing; treat remaining arguments as messages/files
-  --help, -h                     Show this help
-  --version, -v                  Show version number
+${chalk.bold(t("Options:"))}
+  --provider <name>              ${t("Provider name (default: google)")}
+  --model <pattern>              ${t('Model pattern or ID (supports "provider/id" and optional ":<thinking>")')}
+  --api-key <key>                ${t("API key (defaults to env vars)")}
+  --system-prompt <text>         ${t("System prompt (default: coding assistant prompt)")}
+  --append-system-prompt <text>  ${t("Append text or file contents to the system prompt (can be used multiple times)")}
+  --mode <mode>                  ${t("Output mode: text (default), json, or rpc")}
+  --print, -p                    ${t("Non-interactive mode: process prompt and exit")}
+  --continue, -c                 ${t("Continue previous session")}
+  --resume, -r                   ${t("Select a session to resume")}
+  --session <path|id>            ${t("Use specific session file or partial UUID")}
+  --session-id <id>              ${t("Use exact project session ID, creating it if missing")}
+  --fork <path|id>               ${t("Fork specific session file or partial UUID into a new session")}
+  --session-dir <dir>            ${t("Directory for session storage and lookup")}
+  --suite <id>                   ${t("Suite (方案) for this run: coding (default) or assistant; new sessions only")}
+  --suite-create <id>            ${t("Create a user suite workspace and exit; add --clone-from <id> to copy one")}
+  --suite-delete <id>            ${t("Delete a user suite workspace (active session references refuse) and exit")}
+  --suite-reset <id>             ${t("Reset a builtin suite to factory contents (shows a diff) and exit")}
+  --serve <port>                 ${t("(Experimental, local trust only) Serve the coding-agent session runtime over the WebSocket gateway (default: 127.0.0.1; HTTP surface: /healthz plus token-protected artifact reads) and exit on SIGINT/SIGTERM")}
+                                 ${t("Durable journal: <agentDir>/remote-server-journal.jsonl (never the process cwd)")}
+  --serve-workspace-root <dir>   ${t("Opt-in --serve boundary: remote creates must run inside one of these roots (repeatable); without it any local directory is allowed")}
+  --subagent-runner              ${t("(Experimental) Run as a headless subagent runner: serve the subagent-task protocol on stdio for a parent session's runner pool (D-045)")}
+  --no-session                   ${t("Don't save session (ephemeral)")}
+  --name, -n <name>              ${t("Set session display name")}
+  --models <patterns>            ${t("Comma-separated model patterns for Ctrl+P cycling")}
+                                 ${t("Supports globs (anthropic/*, *sonnet*) and fuzzy matching")}
+  --no-tools, -nt                ${t("Disable all tools by default (built-in and plugin)")}
+  --no-builtin-tools, -nbt       ${t("Disable built-in tools by default but keep plugin/custom tools enabled")}
+  --tools, -t <tools>            ${t("Comma-separated allowlist of tool names to enable")}
+                                 ${t("Applies to built-in, plugin, and custom tools")}
+  --exclude-tools, -xt <tools>   ${t("Comma-separated denylist of tool names to disable")}
+                                 ${t("Applies to built-in, plugin, and custom tools")}
+  --thinking <level>             ${t("Set thinking level: off, minimal, low, medium, high, xhigh, max")}
+  --no-plugins, -np               ${t("Disable capability plugin discovery (D-028 escape hatch)")}
+  --no-trace                      ${t("Disable session trace collection (no .trace.jsonl file is written)")}
+  --log-level <level>             ${t("Host log level: debug, info (default), warn, error")}
+  --plugin-profile <id>            ${t("Select a builtin capability plugin profile for this run")}
+  --plugin <id>                    ${t("Select a plugin within the profile (repeatable)")}
+  --disable-plugin <id>            ${t("Disable a plugin within the profile (repeatable)")}
+  --plugin-scope <scope>           ${t("Read the explicit selection from global or project storage")}
+  plugin catalog list             ${t("List installed/available ecosystem plugins (independent namespace)")}
+  --skill <path>                 ${t("Load a skill file or directory (can be used multiple times)")}
+  --no-skills, -ns               ${t("Disable skills discovery and loading")}
+  --prompt-template <path>       ${t("Load a prompt template file or directory (can be used multiple times)")}
+  --no-prompt-templates, -np     ${t("Disable prompt template discovery and loading")}
+  --theme <path>                 ${t("Load a theme file or directory (can be used multiple times)")}
+  --use-theme <name[/name]>      ${t("Set the initial interactive theme for this run")}
+  --no-themes                    ${t("Disable theme discovery and loading")}
+  --no-context-files, -nc        ${t("Disable AGENTS.md and CLAUDE.md discovery and loading")}
+  --export <file>                ${t("Export session file to HTML and exit")}
+  --trace <session>              ${t("View a session trace file as a text timeline and exit; <session> is a session id/prefix or trace/session file path, omit it for the most recent session")}
+  --trace-json                   ${t("With --trace, output the structured trace records as JSON instead of the text timeline")}
+  --trace-kind <k1,k2>           ${t("With --trace, show only records of these kinds (comma-separated); valid kinds: {kinds}", { kinds: TRACE_KINDS_V1.join(", ") })}
+  --trace-limit <n>              ${t("With --trace, show only the last N records (positive integer)")}
+  --list-models [search]         ${t("List available models (with optional fuzzy search)")}
+  --verbose                      ${t("Force verbose startup (overrides quietStartup setting)")}
+  --tui-mode <mode>              ${t("TUI mode: regular (default) or fullscreen")}
+  --offline                      ${t("Disable startup network operations (same as AGENT_FORGE_OFFLINE=1)")}
+  --                             ${t("End option parsing; treat remaining arguments as messages/files")}
+  --help, -h                     ${t("Show this help")}
+  --version, -v                  ${t("Show version number")}
 
-${chalk.bold("Examples:")}
-  # Print a provider API key for an external client
+${chalk.bold(t("Examples:"))}
+  # ${t("Print a provider API key for an external client")}
   ${APP_NAME} auth print-api-key --provider openai
 
-  # Print an OAuth bearer token for an external client (refreshes if expired)
+  # ${t("Print an OAuth bearer token for an external client (refreshes if expired)")}
   ${APP_NAME} auth print-bearer-token --provider openai-codex
 
-  # Interactive mode
+  # ${t("Interactive mode")}
   ${APP_NAME}
 
-  # Interactive mode with initial prompt
+  # ${t("Interactive mode with initial prompt")}
   ${APP_NAME} "List all .ts files in src/"
 
-  # Include files in initial message
+  # ${t("Include files in initial message")}
   ${APP_NAME} @prompt.md @image.png "What color is the sky?"
 
-  # Non-interactive mode (process and exit)
+  # ${t("Non-interactive mode (process and exit)")}
   ${APP_NAME} -p "List all .ts files in src/"
 
-  # Prompt beginning with a dash
+  # ${t("Prompt beginning with a dash")}
   ${APP_NAME} -p -- "- Summarize these points"
 
-  # Multiple messages (interactive)
+  # ${t("Multiple messages (interactive)")}
   ${APP_NAME} "Read package.json" "What dependencies do we have?"
 
-  # Continue previous session
+  # ${t("Continue previous session")}
   ${APP_NAME} --continue "What did we discuss?"
 
-  # Start a named session
+  # ${t("Start a named session")}
   ${APP_NAME} --name "Refactor auth module"
 
-  # Use different model
+  # ${t("Use different model")}
   ${APP_NAME} --provider openai --model gpt-4o-mini "Help me refactor this code"
 
-  # Use model with provider prefix (no --provider needed)
+  # ${t("Use model with provider prefix (no --provider needed)")}
   ${APP_NAME} --model openai/gpt-4o "Help me refactor this code"
 
-  # Use model with thinking level shorthand
+  # ${t("Use model with thinking level shorthand")}
   ${APP_NAME} --model sonnet:high "Solve this complex problem"
 
-  # Limit model cycling to specific models
+  # ${t("Limit model cycling to specific models")}
   ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o
 
-  # Limit to a specific provider with glob pattern
+  # ${t("Limit to a specific provider with glob pattern")}
   ${APP_NAME} --models "github-copilot/*"
 
-  # Cycle models with fixed thinking levels
+  # ${t("Cycle models with fixed thinking levels")}
   ${APP_NAME} --models sonnet:high,haiku:low
 
-  # Start with a specific thinking level
+  # ${t("Start with a specific thinking level")}
   ${APP_NAME} --thinking high "Solve this complex problem"
 
-  # Read-only mode (no file modifications possible)
+  # ${t("Read-only mode (no file modifications possible)")}
   ${APP_NAME} --tools read,grep,find,ls -p "Review the code in src/"
 
-  # Disable one tool while keeping the rest available
+  # ${t("Disable one tool while keeping the rest available")}
   ${APP_NAME} --exclude-tools ask_question
 
-  # Export a session file to HTML
+  # ${t("Export a session file to HTML")}
   ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl
   ${APP_NAME} --export session.jsonl output.html
 
-${chalk.bold("Environment Variables:")}
-  ANTHROPIC_AUTH_TOKEN             - Anthropic bearer auth token
-  ANTHROPIC_API_KEY                - Anthropic Claude API key
-  ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)
-  ANT_LING_API_KEY                 - Ant Ling API key
-  OPENAI_API_KEY                   - OpenAI GPT API key
-  AZURE_OPENAI_API_KEY             - Azure OpenAI API key
-  AZURE_OPENAI_BASE_URL            - Azure OpenAI/Cognitive Services base URL (e.g. https://{resource}.openai.azure.com)
-  AZURE_OPENAI_RESOURCE_NAME       - Azure OpenAI resource name (alternative to base URL)
-  AZURE_OPENAI_API_VERSION         - Azure OpenAI API version (default: v1)
-  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)
-  DEEPSEEK_API_KEY                 - DeepSeek API key
-  NVIDIA_API_KEY                   - NVIDIA NIM API key
-  GEMINI_API_KEY                   - Google Gemini API key
-  GROQ_API_KEY                     - Groq API key
-  CEREBRAS_API_KEY                 - Cerebras API key
-  XAI_API_KEY                      - xAI Grok API key
-  FIREWORKS_API_KEY                - Fireworks API key
-  TOGETHER_API_KEY                 - Together AI API key
-  BASETEN_API_KEY                  - Baseten API key
-  OPENROUTER_API_KEY               - OpenRouter API key
-  AI_GATEWAY_API_KEY               - Vercel AI Gateway API key
-  ZAI_API_KEY                      - ZAI Coding Plan API key (Global)
-  ZAI_CODING_CN_API_KEY            - ZAI Coding Plan API key (China)
-  MISTRAL_API_KEY                  - Mistral API key
-  MINIMAX_API_KEY                  - MiniMax API key
-  MOONSHOT_API_KEY                 - Moonshot AI API key
-  OPENCODE_API_KEY                 - OpenCode Zen/OpenCode Go API key
-  KIMI_API_KEY                     - Kimi For Coding API key
-  CLOUDFLARE_API_KEY               - Cloudflare API token (Workers AI and AI Gateway)
-  CLOUDFLARE_ACCOUNT_ID            - Cloudflare account id (required for both)
-  CLOUDFLARE_GATEWAY_ID            - Cloudflare AI Gateway slug (required for AI Gateway)
-  QWEN_TOKEN_PLAN_API_KEY          - Qwen Token Plan API key (international region)
-  QWEN_TOKEN_PLAN_CN_API_KEY       - Qwen Token Plan API key (China region)
-  XIAOMI_API_KEY                   - Xiaomi MiMo API key (api.xiaomimimo.com billing)
-  XIAOMI_TOKEN_PLAN_CN_API_KEY     - Xiaomi MiMo Token Plan API key (China region)
-  XIAOMI_TOKEN_PLAN_AMS_API_KEY    - Xiaomi MiMo Token Plan API key (Amsterdam region)
-  XIAOMI_TOKEN_PLAN_SGP_API_KEY    - Xiaomi MiMo Token Plan API key (Singapore region)
-  AWS_PROFILE                      - AWS profile for Amazon Bedrock
-  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock
-  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock
-  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)
-  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)
-  ${ENV_AGENT_DIR.padEnd(32)} - Config directory (default: ~/${CONFIG_DIR_NAME}/agent)
-  ${ENV_SESSION_DIR.padEnd(32)} - Session storage directory (overridden by --session-dir)
-  AGENT_FORGE_PACKAGE_DIR                   - Override package directory (for Nix/Guix store paths)
-  AGENT_FORGE_OFFLINE                       - Disable startup network operations when set to 1/true/yes
+${chalk.bold(t("Environment Variables:"))}
+  ANTHROPIC_AUTH_TOKEN             - ${t("Anthropic bearer auth token")}
+  ANTHROPIC_API_KEY                - ${t("Anthropic Claude API key")}
+  ANTHROPIC_OAUTH_TOKEN            - ${t("Anthropic OAuth token (alternative to API key)")}
+  ANT_LING_API_KEY                 - ${t("Ant Ling API key")}
+  OPENAI_API_KEY                   - ${t("OpenAI GPT API key")}
+  AZURE_OPENAI_API_KEY             - ${t("Azure OpenAI API key")}
+  AZURE_OPENAI_BASE_URL            - ${t("Azure OpenAI/Cognitive Services base URL (e.g. https://{resource}.openai.azure.com)")}
+  AZURE_OPENAI_RESOURCE_NAME       - ${t("Azure OpenAI resource name (alternative to base URL)")}
+  AZURE_OPENAI_API_VERSION         - ${t("Azure OpenAI API version (default: v1)")}
+  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - ${t("Azure OpenAI model=deployment map (comma-separated)")}
+  DEEPSEEK_API_KEY                 - ${t("DeepSeek API key")}
+  NVIDIA_API_KEY                   - ${t("NVIDIA NIM API key")}
+  GEMINI_API_KEY                   - ${t("Google Gemini API key")}
+  GROQ_API_KEY                     - ${t("Groq API key")}
+  CEREBRAS_API_KEY                 - ${t("Cerebras API key")}
+  XAI_API_KEY                      - ${t("xAI Grok API key")}
+  FIREWORKS_API_KEY                - ${t("Fireworks API key")}
+  TOGETHER_API_KEY                 - ${t("Together AI API key")}
+  BASETEN_API_KEY                  - ${t("Baseten API key")}
+  OPENROUTER_API_KEY               - ${t("OpenRouter API key")}
+  AI_GATEWAY_API_KEY               - ${t("Vercel AI Gateway API key")}
+  ZAI_API_KEY                      - ${t("ZAI Coding Plan API key (Global)")}
+  ZAI_CODING_CN_API_KEY            - ${t("ZAI Coding Plan API key (China)")}
+  MISTRAL_API_KEY                  - ${t("Mistral API key")}
+  MINIMAX_API_KEY                  - ${t("MiniMax API key")}
+  MOONSHOT_API_KEY                 - ${t("Moonshot AI API key")}
+  OPENCODE_API_KEY                 - ${t("OpenCode Zen/OpenCode Go API key")}
+  KIMI_API_KEY                     - ${t("Kimi For Coding API key")}
+  CLOUDFLARE_API_KEY               - ${t("Cloudflare API token (Workers AI and AI Gateway)")}
+  CLOUDFLARE_ACCOUNT_ID            - ${t("Cloudflare account id (required for both)")}
+  CLOUDFLARE_GATEWAY_ID            - ${t("Cloudflare AI Gateway slug (required for AI Gateway)")}
+  QWEN_TOKEN_PLAN_API_KEY          - ${t("Qwen Token Plan API key (international region)")}
+  QWEN_TOKEN_PLAN_CN_API_KEY       - ${t("Qwen Token Plan API key (China region)")}
+  XIAOMI_API_KEY                   - ${t("Xiaomi MiMo API key (api.xiaomimimo.com billing)")}
+  XIAOMI_TOKEN_PLAN_CN_API_KEY     - ${t("Xiaomi MiMo Token Plan API key (China region)")}
+  XIAOMI_TOKEN_PLAN_AMS_API_KEY    - ${t("Xiaomi MiMo Token Plan API key (Amsterdam region)")}
+  XIAOMI_TOKEN_PLAN_SGP_API_KEY    - ${t("Xiaomi MiMo Token Plan API key (Singapore region)")}
+  AWS_PROFILE                      - ${t("AWS profile for Amazon Bedrock")}
+  AWS_ACCESS_KEY_ID                - ${t("AWS access key for Amazon Bedrock")}
+  AWS_SECRET_ACCESS_KEY            - ${t("AWS secret key for Amazon Bedrock")}
+  AWS_BEARER_TOKEN_BEDROCK         - ${t("Bedrock API key (bearer token)")}
+  AWS_REGION                       - ${t("AWS region for Amazon Bedrock (e.g., us-east-1)")}
+  ${ENV_AGENT_DIR.padEnd(32)} - ${t("Config directory (default: ~/{configDir}/agent)", { configDir: CONFIG_DIR_NAME })}
+  ${ENV_SESSION_DIR.padEnd(32)} - ${t("Session storage directory (overridden by --session-dir)")}
+  AGENT_FORGE_PACKAGE_DIR                   - ${t("Override package directory (for Nix/Guix store paths)")}
+  AGENT_FORGE_OFFLINE                       - ${t("Disable startup network operations when set to 1/true/yes")}
 
-${chalk.bold("Built-in Tool Names:")}
-  read       - Read file contents
-  bash       - Execute bash commands
-  powershell - Execute PowerShell commands on Windows
-  edit       - Edit files with find/replace
-  write      - Write files (creates/overwrites)
-  grep       - Search file contents (read-only, off by default)
-  find       - Find files by glob pattern (read-only, off by default)
-  ls         - List directory contents (read-only, off by default)
+${chalk.bold(t("Built-in Tool Names:"))}
+  read       - ${t("Read file contents")}
+  bash       - ${t("Execute bash commands")}
+  powershell - ${t("Execute PowerShell commands on Windows")}
+  edit       - ${t("Edit files with find/replace")}
+  write      - ${t("Write files (creates/overwrites)")}
+  grep       - ${t("Search file contents (read-only, off by default)")}
+  find       - ${t("Find files by glob pattern (read-only, off by default)")}
+  ls         - ${t("List directory contents (read-only, off by default)")}
 `);
 }
 //# sourceMappingURL=args.js.map