@oh-my-pi/pi-coding-agent 17.2.4 → 17.2.5

package/src/commands/gallery.ts

@@ -1,12 +1,13 @@
 /**
  * Render every built-in tool's renderer across its lifecycle states.
  */
+
 import { Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { galleryHelp as commandHelp } from "../cli/command-help";
 import { GALLERY_STATE_TOKENS, type GalleryState, parseGalleryStates, runGalleryCommand } from "../cli/gallery-cli";
 
 export default class Gallery extends Command {
-	static description = "Preview tool renderers across streaming, in-progress, success, and failure states";
-
+	static description = commandHelp.description;
 	static flags = {
 		tool: Flags.string({ char: "t", description: "Render a single tool by name" }),
 		state: Flags.string({

package/src/commands/gc.ts

@@ -1,12 +1,13 @@
 /**
  * Run on-disk storage maintenance.
  */
+
 import { Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { gcHelp as commandHelp } from "../cli/command-help";
 import { collectGcErrors, type GcCommandArgs, runGcCommand } from "../cli/gc-cli";
 
 export default class Gc extends Command {
-	static description = "Run storage garbage collection";
-
+	static description = commandHelp.description;
 	static flags = {
 		apply: Flags.boolean({ description: "Apply changes (default is dry-run)" }),
 		json: Flags.boolean({ description: "Output JSON" }),

package/src/commands/grep.ts

@@ -1,14 +1,15 @@
 /**
  * Test grep tool.
  */
+
 import { GrepOutputMode } from "@oh-my-pi/pi-natives";
 import { Args, Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { grepHelp as commandHelp } from "../cli/command-help";
 import { type GrepCommandArgs, runGrepCommand } from "../cli/grep-cli";
 import { initTheme } from "../modes/theme/theme";
 
 export default class Grep extends Command {
-	static description = "Test grep tool";
-
+	static description = commandHelp.description;
 	static args = {
 		pattern: Args.string({ description: "Regex pattern to search for", required: false }),
 		path: Args.string({ description: "Directory or file to search", required: false }),

package/src/commands/grievances.ts

@@ -1,12 +1,13 @@
 /**
  * View, clean, and push reported tool issues from automated QA.
  */
+
 import { Args, Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { grievancesHelp as commandHelp } from "../cli/command-help";
 import { cleanGrievances, listGrievances, pushGrievances } from "../cli/grievances-cli";
 
 export default class Grievances extends Command {
-	static description = "View, clean, or push reported tool issues (auto-QA grievances)";
-
+	static description = commandHelp.description;
 	static args = {
 		// Positional action: "list" (default), "clean", or "push". A positional
 		// arg keeps the historical `omp grievances` invocation working unchanged

package/src/commands/install.ts

@@ -21,6 +21,7 @@
 import { existsSync } from "node:fs";
 import * as path from "node:path";
 import { Args, Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { installHelp as commandHelp } from "../cli/command-help";
 import { type PluginAction, type PluginCommandArgs, runPluginCommand } from "../cli/plugin-cli";
 import { initTheme } from "../modes/theme/theme";
 
@@ -41,8 +42,7 @@ export function looksLikeLocalPath(target: string, cwd?: string): boolean {
 }
 
 export default class Install extends Command {
-	static description = "Install or link an extension package (alias of `plugin install`/`plugin link`)";
-
+	static description = commandHelp.description;
 	static args = {
 		targets: Args.string({
 			description: "Local path, npm spec, or marketplace ref (e.g. ./my-ext, my-pkg@1.2.3, name@marketplace)",

package/src/commands/join.ts

@@ -2,14 +2,15 @@
  * Join a shared collab session from the CLI: launches the interactive TUI and
  * immediately runs `/join <link>`.
  */
+
 import { APP_NAME } from "@oh-my-pi/pi-utils";
 import { Args, Command } from "@oh-my-pi/pi-utils/cli";
 import { parseArgs } from "../cli/args";
+import { joinHelp as commandHelp } from "../cli/command-help";
 import { runRootCommand } from "../main";
 
 export default class Join extends Command {
-	static description = "Join a shared collab session (same as /join)";
-
+	static description = commandHelp.description;
 	static args = {
 		link: Args.string({
 			description: "Collab link shared by the host (/collab)",

package/src/commands/launch-help.ts

@@ -0,0 +1,116 @@
+import { Args, type CommandMetadata, Flags } from "@oh-my-pi/pi-utils/cli";
+import { APP_NAME } from "@oh-my-pi/pi-utils/dirs";
+import { CLI_THINKING_LEVELS } from "../cli/thinking-levels";
+import { SERVICE_TIER_OPENAI_VALUES } from "../config/service-tier";
+
+export const launchHelp = {
+	description: "AI coding assistant",
+	hidden: true,
+	args: {
+		messages: Args.string({
+			description: "Messages to send (prefix files with @)",
+			required: false,
+			multiple: true,
+		}),
+	},
+	flags: {
+		model: Flags.string({
+			description: 'Model to use (fuzzy match: "opus", "gpt-5.2", or "openai/gpt-5.2")',
+		}),
+		smol: Flags.string({ description: "Smol/fast model for lightweight tasks (or PI_SMOL_MODEL env)" }),
+		slow: Flags.string({ description: "Slow/reasoning model for thorough analysis (or PI_SLOW_MODEL env)" }),
+		plan: Flags.string({ description: "Plan model for architectural planning (or PI_PLAN_MODEL env)" }),
+		prewalk: Flags.boolean({
+			description:
+				"Switch from the active model to a fast/cheap model at the first edit/write after the plan's todo list exists (default off; see prewalk.enabled)",
+		}),
+		"no-prewalk": Flags.boolean({ description: "Disable prewalk even if prewalk.enabled is set" }),
+		"prewalk-into": Flags.string({ description: 'Target model for prewalk (default the "smol" role)' }),
+		"plan-yolo": Flags.boolean({
+			description:
+				"Force read-only plan mode at start, auto-approve the plan on the model's first resolve call, then switch to --plan-yolo-into to implement it",
+		}),
+		"plan-yolo-into": Flags.string({ description: 'Target model for plan-yolo execution (default the "smol" role)' }),
+		provider: Flags.string({ description: "Provider to use (legacy; prefer --model)" }),
+		"api-key": Flags.string({ description: "API key (defaults to env vars)" }),
+		"system-prompt": Flags.string({ description: "System prompt (default: coding assistant prompt)" }),
+		"append-system-prompt": Flags.string({ description: "Append text or file contents to the system prompt" }),
+		"allow-home": Flags.boolean({ description: "Allow starting in ~ without auto-switching to a temp dir" }),
+		profile: Flags.string({ description: "Use an isolated profile for auth, sessions, settings, and caches" }),
+		alias: Flags.string({ description: "Create a shell shortcut for the selected profile and exit" }),
+		cwd: Flags.string({ description: "Directory to start in (overrides the launch cwd)" }),
+		mode: Flags.string({
+			description: "Output mode: text (default), json, rpc, or rpc-ui",
+			options: ["text", "json", "rpc", "acp", "rpc-ui"],
+		}),
+		config: Flags.string({
+			description: "Load an extra config.yml-style overlay for this run (repeatable)",
+			multiple: true,
+		}),
+		"add-dir": Flags.string({
+			description: "Add a workspace directory beyond the working directory (repeatable)",
+			multiple: true,
+		}),
+		print: Flags.boolean({ char: "p", description: "Non-interactive mode: process prompt and exit" }),
+		continue: Flags.boolean({ char: "c", description: "Continue previous session" }),
+		resume: Flags.string({ char: "r", description: "Resume a session (by ID prefix, path, or picker if omitted)" }),
+		"from-claude": Flags.boolean({ description: "Import a Claude Code session into OMP" }),
+		"from-codex": Flags.boolean({ description: "Import a Codex session into OMP" }),
+		"session-dir": Flags.string({ description: "Directory for session storage and lookup" }),
+		"no-session": Flags.boolean({ description: "Don't save session (ephemeral)" }),
+		models: Flags.string({ description: "Comma-separated model patterns for Ctrl+P cycling" }),
+		"no-tools": Flags.boolean({ description: "Disable all built-in tools" }),
+		"no-lsp": Flags.boolean({ description: "Disable LSP tools, formatting, and diagnostics" }),
+		"no-pty": Flags.boolean({ description: "Disable PTY-based interactive bash execution" }),
+		tools: Flags.string({ description: "Comma-separated list of tools to enable (default: all)" }),
+		thinking: Flags.string({
+			description: `Set thinking level: ${CLI_THINKING_LEVELS.join(", ")}`,
+			options: [...CLI_THINKING_LEVELS],
+		}),
+		"service-tier": Flags.string({
+			description: "OpenAI service tier for this session (none omits service_tier)",
+			options: [...SERVICE_TIER_OPENAI_VALUES],
+		}),
+		"hide-thinking": Flags.boolean({
+			description: "Hide thinking blocks in TUI output (display only, does not disable model thinking)",
+		}),
+		advisor: Flags.boolean({
+			description: "Enable the advisor runtime (passively reviews each turn and injects notes)",
+		}),
+		hook: Flags.string({ description: "Load a hook/extension file (can be used multiple times)", multiple: true }),
+		extension: Flags.string({
+			char: "e",
+			description: "Load an extension file (can be used multiple times)",
+			multiple: true,
+		}),
+		"no-extensions": Flags.boolean({
+			description: "Disable extension discovery (explicit -e paths still work)",
+		}),
+		"no-skills": Flags.boolean({ description: "Disable skills discovery and loading" }),
+		skills: Flags.string({ description: "Comma-separated glob patterns to filter skills (e.g., git-*,docker)" }),
+		"no-rules": Flags.boolean({ description: "Disable rules discovery and loading" }),
+		export: Flags.string({ description: "Export session file to HTML and exit" }),
+		"no-title": Flags.boolean({ description: "Disable title auto-generation" }),
+		"print-thoughts": Flags.boolean({ description: "Include thinking blocks in print mode text output" }),
+		"max-time": Flags.string({ description: "Stop the session after this duration (e.g., 600, 10m, 1h)" }),
+		"auto-approve": Flags.boolean({
+			aliases: ["yolo"],
+			description: "Auto-approve all tool calls (skip approval prompts)",
+		}),
+		"approval-mode": Flags.string({
+			options: ["always-ask", "write", "yolo"],
+			description: "Override tools.approvalMode for this session (always-ask|write|yolo)",
+		}),
+	},
+	examples: [
+		`# Interactive mode\n  ${APP_NAME}`,
+		`# Interactive mode with initial prompt\n  ${APP_NAME} "List all .ts files in src/"`,
+		`# Include files in initial message\n  ${APP_NAME} @prompt.md @image.png "What color is the sky?"`,
+		`# Non-interactive mode (process and exit)\n  ${APP_NAME} -p "List all .ts files in src/"`,
+		`# Continue previous session\n  ${APP_NAME} --continue "What did we discuss?"`,
+		`# Create a shell shortcut for a work profile\n  ${APP_NAME} --profile work --alias omp-work`,
+		`# Use different model (fuzzy matching)\n  ${APP_NAME} --model opus "Help me refactor this code"`,
+		`# Limit model cycling to specific models\n  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o`,
+		`# Export a session file to HTML\n  ${APP_NAME} --export ~/.omp/agent/sessions/--path--/session.jsonl`,
+	],
+} satisfies CommandMetadata;

package/src/commands/launch.ts

@@ -2,202 +2,18 @@
  * Root command for the coding agent CLI.
  */
 
-import { APP_NAME } from "@oh-my-pi/pi-utils";
-import { Args, Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { Command } from "@oh-my-pi/pi-utils/cli";
 import { type Args as ParsedArgs, parseArgs, reportCliUsageError } from "../cli/args";
 import { runRootCommand } from "../main";
 import { prepareAcpTerminalAuthArgs } from "../modes/acp/terminal-auth";
-import { CLI_THINKING_LEVELS } from "../thinking";
+import { launchHelp } from "./launch-help";
 
 export default class Index extends Command {
-	static description = "AI coding assistant";
-	static hidden = true;
-
-	static args = {
-		messages: Args.string({
-			description: "Messages to send (prefix files with @)",
-			required: false,
-			multiple: true,
-		}),
-	};
-
-	static flags = {
-		model: Flags.string({
-			description: 'Model to use (fuzzy match: "opus", "gpt-5.2", or "openai/gpt-5.2")',
-		}),
-		smol: Flags.string({
-			description: "Smol/fast model for lightweight tasks (or PI_SMOL_MODEL env)",
-		}),
-		slow: Flags.string({
-			description: "Slow/reasoning model for thorough analysis (or PI_SLOW_MODEL env)",
-		}),
-		plan: Flags.string({
-			description: "Plan model for architectural planning (or PI_PLAN_MODEL env)",
-		}),
-		prewalk: Flags.boolean({
-			description:
-				"Switch from the active model to a fast/cheap model at the first edit/write after the plan's todo list exists (default off; see prewalk.enabled)",
-		}),
-		"no-prewalk": Flags.boolean({
-			description: "Disable prewalk even if prewalk.enabled is set",
-		}),
-		"prewalk-into": Flags.string({
-			description: 'Target model for prewalk (default the "smol" role)',
-		}),
-		"plan-yolo": Flags.boolean({
-			description:
-				"Force read-only plan mode at start, auto-approve the plan on the model's first resolve call, then switch to --plan-yolo-into to implement it",
-		}),
-		"plan-yolo-into": Flags.string({
-			description: 'Target model for plan-yolo execution (default the "smol" role)',
-		}),
-		provider: Flags.string({
-			description: "Provider to use (legacy; prefer --model)",
-		}),
-		"api-key": Flags.string({
-			description: "API key (defaults to env vars)",
-		}),
-		"system-prompt": Flags.string({
-			description: "System prompt (default: coding assistant prompt)",
-		}),
-		"append-system-prompt": Flags.string({
-			description: "Append text or file contents to the system prompt",
-		}),
-		"allow-home": Flags.boolean({
-			description: "Allow starting in ~ without auto-switching to a temp dir",
-		}),
-		profile: Flags.string({
-			description: "Use an isolated profile for auth, sessions, settings, and caches",
-		}),
-		alias: Flags.string({
-			description: "Create a shell shortcut for the selected profile and exit",
-		}),
-		cwd: Flags.string({
-			description: "Directory to start in (overrides the launch cwd)",
-		}),
-		mode: Flags.string({
-			description: "Output mode: text (default), json, rpc, or rpc-ui",
-			options: ["text", "json", "rpc", "acp", "rpc-ui"],
-		}),
-		config: Flags.string({
-			description: "Load an extra config.yml-style overlay for this run (repeatable)",
-			multiple: true,
-		}),
-		"add-dir": Flags.string({
-			description: "Add a workspace directory beyond the working directory (repeatable)",
-			multiple: true,
-		}),
-		print: Flags.boolean({
-			char: "p",
-			description: "Non-interactive mode: process prompt and exit",
-		}),
-		continue: Flags.boolean({
-			char: "c",
-			description: "Continue previous session",
-		}),
-		resume: Flags.string({
-			char: "r",
-			description: "Resume a session (by ID prefix, path, or picker if omitted)",
-		}),
-		"from-claude": Flags.boolean({
-			description: "Import a Claude Code session into OMP",
-		}),
-		"from-codex": Flags.boolean({
-			description: "Import a Codex session into OMP",
-		}),
-		"session-dir": Flags.string({
-			description: "Directory for session storage and lookup",
-		}),
-		"no-session": Flags.boolean({
-			description: "Don't save session (ephemeral)",
-		}),
-		models: Flags.string({
-			description: "Comma-separated model patterns for Ctrl+P cycling",
-		}),
-		"no-tools": Flags.boolean({
-			description: "Disable all built-in tools",
-		}),
-		"no-lsp": Flags.boolean({
-			description: "Disable LSP tools, formatting, and diagnostics",
-		}),
-		"no-pty": Flags.boolean({
-			description: "Disable PTY-based interactive bash execution",
-		}),
-		tools: Flags.string({
-			description: "Comma-separated list of tools to enable (default: all)",
-		}),
-		thinking: Flags.string({
-			description: `Set thinking level: ${CLI_THINKING_LEVELS.join(", ")}`,
-			options: [...CLI_THINKING_LEVELS],
-		}),
-		"hide-thinking": Flags.boolean({
-			description: "Hide thinking blocks in TUI output (display only, does not disable model thinking)",
-		}),
-		advisor: Flags.boolean({
-			description: "Enable the advisor runtime (passively reviews each turn and injects notes)",
-		}),
-		hook: Flags.string({
-			description: "Load a hook/extension file (can be used multiple times)",
-			multiple: true,
-		}),
-		extension: Flags.string({
-			char: "e",
-			description: "Load an extension file (can be used multiple times)",
-			multiple: true,
-		}),
-		"no-extensions": Flags.boolean({
-			description: "Disable extension discovery (explicit -e paths still work)",
-		}),
-		"no-skills": Flags.boolean({
-			description: "Disable skills discovery and loading",
-		}),
-		skills: Flags.string({
-			description: "Comma-separated glob patterns to filter skills (e.g., git-*,docker)",
-		}),
-		"no-rules": Flags.boolean({
-			description: "Disable rules discovery and loading",
-		}),
-		export: Flags.string({
-			description: "Export session file to HTML and exit",
-		}),
-		"no-title": Flags.boolean({
-			description: "Disable title auto-generation",
-		}),
-		"print-thoughts": Flags.boolean({
-			description: "Include thinking blocks in print mode text output",
-		}),
-		"max-time": Flags.string({
-			description: "Stop the session after this duration (e.g., 600, 10m, 1h)",
-		}),
-		// `--auto-approve` / `--yolo`: declared here so oclif's auto-generated `--help` lists it.
-		// Runtime parsing happens in `cli/args.ts parseArgs` (line 176 in that file) — `runRootCommand`
-		// consumes the manual-parser output, not these oclif flag values. If you rename or remove
-		// either form, update both call sites in lockstep.
-		"auto-approve": Flags.boolean({
-			aliases: ["yolo"],
-			description: "Auto-approve all tool calls (skip approval prompts)",
-		}),
-		// `--approval-mode`: declared here so oclif's auto-generated `--help` lists it; runtime parsing
-		// happens in `cli/args.ts parseArgs`. The value is applied via `Settings.override("tools.approvalMode", …)`
-		// in `main.ts` after the `Settings` instance is constructed, so every `settings.get("tools.approvalMode")`
-		// site (wrapper, `/settings` UI) observes the same value.
-		"approval-mode": Flags.string({
-			options: ["always-ask", "write", "yolo"],
-			description: "Override tools.approvalMode for this session (always-ask|write|yolo)",
-		}),
-	};
-
-	static examples = [
-		`# Interactive mode\n  ${APP_NAME}`,
-		`# Interactive mode with initial prompt\n  ${APP_NAME} "List all .ts files in src/"`,
-		`# Include files in initial message\n  ${APP_NAME} @prompt.md @image.png "What color is the sky?"`,
-		`# Non-interactive mode (process and exit)\n  ${APP_NAME} -p "List all .ts files in src/"`,
-		`# Continue previous session\n  ${APP_NAME} --continue "What did we discuss?"`,
-		`# Create a shell shortcut for a work profile\n  ${APP_NAME} --profile work --alias omp-work`,
-		`# Use different model (fuzzy matching)\n  ${APP_NAME} --model opus "Help me refactor this code"`,
-		`# Limit model cycling to specific models\n  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o`,
-		`# Export a session file to HTML\n  ${APP_NAME} --export ~/.omp/agent/sessions/--path--/session.jsonl`,
-	];
+	static description = launchHelp.description;
+	static hidden = launchHelp.hidden;
+	static args = launchHelp.args;
+	static flags = launchHelp.flags;
+	static examples = launchHelp.examples;
 
 	static strict = false;
 

package/src/commands/models.ts

@@ -1,13 +1,14 @@
 /**
  * List, search, and refresh available models.
  */
+
 import { APP_NAME } from "@oh-my-pi/pi-utils";
 import { Args, Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { modelsHelp as commandHelp } from "../cli/command-help";
 import { resolveModelsArgs, runModelsCommand } from "../cli/models-cli";
 
 export default class Models extends Command {
-	static description = "List, search, and refresh available models";
-
+	static description = commandHelp.description;
 	static args = {
 		action: Args.string({
 			description: "ls (default) | find | refresh | <provider>",

package/src/commands/plugin.ts

@@ -1,7 +1,9 @@
 /**
  * Manage plugins (install, uninstall, list, etc.).
  */
+
 import { Args, Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { pluginHelp as commandHelp } from "../cli/command-help";
 import { type PluginAction, type PluginCommandArgs, runPluginCommand } from "../cli/plugin-cli";
 import { initTheme } from "../modes/theme/theme";
 
@@ -21,8 +23,7 @@ const ACTIONS: PluginAction[] = [
 ];
 
 export default class Plugin extends Command {
-	static description = "Manage plugins (install, uninstall, list, etc.)";
-
+	static description = commandHelp.description;
 	static args = {
 		action: Args.string({
 			description: "Plugin action",

package/src/commands/read.ts

@@ -1,13 +1,14 @@
 /**
  * Show what the read tool will return for a path, URL, or internal URI.
  */
+
 import { Args, Command } from "@oh-my-pi/pi-utils/cli";
+import { readHelp as commandHelp } from "../cli/command-help";
 import { type ReadCommandArgs, runReadCommand } from "../cli/read-cli";
 import { initTheme } from "../modes/theme/theme";
 
 export default class Read extends Command {
-	static description = "Show what the read tool will return for a path, URL, or internal URI";
-
+	static description = commandHelp.description;
 	static args = {
 		path: Args.string({
 			description:

package/src/commands/say.ts

@@ -8,9 +8,11 @@
  * streamed segments into one WAV. The first run downloads the configured local
  * model into the worker's cache.
  */
+
 import { getProjectDir } from "@oh-my-pi/pi-utils";
 import { Args, Command, Flags } from "@oh-my-pi/pi-utils/cli";
 import chalk from "chalk";
+import { sayHelp as commandHelp } from "../cli/command-help";
 import { Settings, settings } from "../config/settings";
 import { TTS_LOCAL_VOICE_VALUES } from "../tts/models";
 import { SpeakableStream } from "../tts/speakable";
@@ -19,8 +21,7 @@ import { shutdownTtsClient, ttsClient } from "../tts/tts-client";
 import { encodeWav } from "../tts/wav";
 
 export default class Say extends Command {
-	static description = "Synthesize text with the local TTS engine and play it through the speakers";
-
+	static description = commandHelp.description;
 	static args = {
 		text: Args.string({ description: "Text to speak (or use --file)" }),
 	};

package/src/commands/setup.ts

@@ -1,8 +1,10 @@
 /**
  * Run onboarding setup or install dependencies for optional features.
  */
+
 import { Args, Command, Flags, renderCommandHelp } from "@oh-my-pi/pi-utils/cli";
 import { parseArgs } from "../cli/args";
+import { setupHelp as commandHelp } from "../cli/command-help";
 import { runSetupCommand, type SetupCommandArgs, type SetupComponent } from "../cli/setup-cli";
 import { runRootCommand } from "../main";
 import { initTheme } from "../modes/theme/theme";
@@ -29,8 +31,7 @@ export async function runOnboardingSetup(deps: OnboardingSetupDependencies = {})
 }
 
 export default class Setup extends Command {
-	static description = "Run onboarding setup or install dependencies for optional features";
-
+	static description = commandHelp.description;
 	static args = {
 		component: Args.string({
 			description: "Optional component to install",

package/src/commands/shell.ts

@@ -1,13 +1,14 @@
 /**
  * Interactive shell console.
  */
+
 import { Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { shellHelp as commandHelp } from "../cli/command-help";
 import { runShellCommand, type ShellCommandArgs } from "../cli/shell-cli";
 import { initTheme } from "../modes/theme/theme";
 
 export default class Shell extends Command {
-	static description = "Interactive shell console";
-
+	static description = commandHelp.description;
 	static flags = {
 		cwd: Flags.string({ char: "C", description: "Set working directory for commands" }),
 		timeout: Flags.integer({ char: "t", description: "Timeout per command in milliseconds" }),

package/src/commands/ssh.ts

@@ -1,15 +1,16 @@
 /**
  * Manage SSH host configurations.
  */
+
 import { Args, Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { sshHelp as commandHelp } from "../cli/command-help";
 import { runSSHCommand, type SSHAction, type SSHCommandArgs } from "../cli/ssh-cli";
 import { initTheme } from "../modes/theme/theme";
 
 const ACTIONS: SSHAction[] = ["add", "remove", "list"];
 
 export default class SSH extends Command {
-	static description = "Manage SSH host configurations";
-
+	static description = commandHelp.description;
 	static args = {
 		action: Args.string({
 			description: "SSH action",

package/src/commands/stats.ts

@@ -1,13 +1,14 @@
 /**
  * View usage statistics dashboard.
  */
+
 import { Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { statsHelp as commandHelp } from "../cli/command-help";
 import { runStatsCommand, type StatsCommandArgs } from "../cli/stats-cli";
 import { initTheme } from "../modes/theme/theme";
 
 export default class Stats extends Command {
-	static description = "View usage statistics";
-
+	static description = commandHelp.description;
 	static flags = {
 		port: Flags.integer({ char: "p", description: "Port for the dashboard server", default: 3847 }),
 		json: Flags.boolean({ char: "j", description: "Output stats as JSON", default: false }),

package/src/commands/tiny-models.ts

@@ -1,11 +1,11 @@
 import { Args, Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { tinyModelsHelp as commandHelp } from "../cli/command-help";
 import { runTinyModelsCommand, type TinyModelsAction, type TinyModelsCommandArgs } from "../cli/tiny-models-cli";
 
 const ACTIONS: TinyModelsAction[] = ["download", "list"];
 
 export default class TinyModels extends Command {
-	static description = "Download tiny local models (session titles + memory)";
-
+	static description = commandHelp.description;
 	static args = {
 		action: Args.string({
 			description: "Action to perform",

package/src/commands/token.ts

@@ -5,13 +5,13 @@
 import { PROVIDER_REGISTRY } from "@oh-my-pi/pi-ai";
 import { Args, Command, Flags } from "@oh-my-pi/pi-utils/cli";
 import chalk from "chalk";
+import { tokenHelp as commandHelp } from "../cli/command-help";
 import { isAuthenticated, ModelRegistry } from "../config/model-registry";
 import { discoverAuthStorage } from "../sdk";
 import { getAvailableAuthMethods } from "../web/search/providers/perplexity-auth";
 
 export default class Token extends Command {
-	static description = "Get the API key or OAuth token for a provider";
-
+	static description = commandHelp.description;
 	static args = {
 		provider: Args.string({
 			description: "Provider ID (e.g. anthropic, openai)",

package/src/commands/ttsr.ts

@@ -8,6 +8,7 @@ import * as path from "node:path";
  * shows every TTSR-registered rule the current project/user config would load.
  */
 import { Args, Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { ttsrHelp as commandHelp } from "../cli/command-help";
 import {
 	runTtsrCommand,
 	TTSR_ACTIONS,
@@ -19,8 +20,7 @@ import {
 import type { TtsrMatchSource } from "../export/ttsr";
 
 export default class Ttsr extends Command {
-	static description = "Inspect and test Time-Traveling Stream Rules (TTSR)";
-
+	static description = commandHelp.description;
 	static args = {
 		action: Args.string({
 			description: "TTSR action",

package/src/commands/update.ts

@@ -1,14 +1,15 @@
 /**
  * Check for and install updates.
  */
+
 import { Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { updateHelp as commandHelp } from "../cli/command-help";
 import * as pluginCli from "../cli/plugin-cli";
 import * as updateCli from "../cli/update-cli";
 import { initTheme } from "../modes/theme/theme";
 
 export default class Update extends Command {
-	static description = "Check for and install updates";
-
+	static description = commandHelp.description;
 	static flags = {
 		force: Flags.boolean({ char: "f", description: "Force update", default: false }),
 		check: Flags.boolean({ char: "c", description: "Check for updates without installing", default: false }),