@os-eco/overstory-cli 0.6.5 → 0.6.6

package/src/agents/overlay.test.ts

@@ -134,7 +134,7 @@ describe("generateOverlay", () => {
 		const config = makeConfig({ mulchDomains: ["typescript", "testing"] });
 		const output = await generateOverlay(config);
 
-		expect(output).toContain("mulch prime typescript testing");
+		expect(output).toContain("ml prime typescript testing");
 	});
 
 	test("empty mulch domains shows fallback text", async () => {
@@ -159,7 +159,7 @@ describe("generateOverlay", () => {
 		});
 		const output = await generateOverlay(config);
 
-		expect(output).toContain("overstory sling");
+		expect(output).toContain("ov sling");
 		expect(output).toContain("--parent lead-alpha");
 		expect(output).toContain("--depth 2");
 	});
@@ -267,7 +267,7 @@ describe("generateOverlay", () => {
 		const output = await generateOverlay(config);
 
 		expect(output).toContain("bd close overstory-task1");
-		expect(output).toContain("overstory mail send --to lead-alpha");
+		expect(output).toContain("ov mail send --to lead-alpha");
 	});
 
 	test("reviewer completion section uses coordinator when no parent", async () => {
@@ -284,8 +284,8 @@ describe("generateOverlay", () => {
 		const config = makeConfig({ agentName: "worker-42" });
 		const output = await generateOverlay(config);
 
-		expect(output).toContain("overstory mail check --agent worker-42");
-		expect(output).toContain("overstory mail send --to");
+		expect(output).toContain("ov mail check --agent worker-42");
+		expect(output).toContain("ov mail send --to");
 	});
 
 	test("output includes base agent definition content (Layer 1)", async () => {

package/src/agents/overlay.ts

@@ -24,14 +24,14 @@ function formatFileScope(fileScope: readonly string[]): string {
 }
 
 /**
- * Format mulch domains as a `mulch prime` command.
+ * Format mulch domains as a `ml prime` command.
  * Returns a human-readable fallback if no domains are configured.
  */
 function formatMulchDomains(domains: readonly string[]): string {
 	if (domains.length === 0) {
 		return "No specific expertise domains configured";
 	}
-	return `\`\`\`bash\nmulch prime ${domains.join(" ")}\n\`\`\``;
+	return `\`\`\`bash\nml prime ${domains.join(" ")}\n\`\`\``;
 }
 
 /**
@@ -90,9 +90,9 @@ function formatQualityGates(config: OverlayConfig): string {
 			"",
 			"Before reporting completion:",
 			"",
-			`1. **Record mulch learnings:** \`mulch record <domain> --type <convention|pattern|reference> --description "..."\` — capture reusable knowledge from your work`,
+			`1. **Record mulch learnings:** \`ml record <domain> --type <convention|pattern|reference> --description "..."\` — capture reusable knowledge from your work`,
 			`2. **Close issue:** \`${config.trackerCli ?? "bd"} close ${config.taskId} --reason "summary of findings"\``,
-			`3. **Send results:** \`overstory mail send --to ${config.parentAgent ?? "coordinator"} --subject "done" --body "Summary" --type result --agent ${config.agentName}\``,
+			`3. **Send results:** \`ov mail send --to ${config.parentAgent ?? "coordinator"} --subject "done" --body "Summary" --type result --agent ${config.agentName}\``,
 			"",
 			"You are a read-only agent. Do NOT commit, modify files, or run quality gates.",
 		].join("\n");
@@ -112,12 +112,12 @@ function formatQualityGates(config: OverlayConfig): string {
 		"",
 		...gateLines,
 		`${gateLines.length + 1}. **Commit:** all changes committed to your branch (${config.branchName})`,
-		`${gateLines.length + 2}. **Record mulch learnings:** \`mulch record <domain> --type <convention|pattern|failure|decision> --description "..." --outcome-status success --outcome-agent ${config.agentName}\` — capture insights from your work`,
-		`${gateLines.length + 3}. **Signal completion:** send \`worker_done\` mail to ${config.parentAgent ?? "coordinator"}: \`overstory mail send --to ${config.parentAgent ?? "coordinator"} --subject "Worker done: ${config.taskId}" --body "Quality gates passed." --type worker_done --agent ${config.agentName}\``,
+		`${gateLines.length + 2}. **Record mulch learnings:** \`ml record <domain> --type <convention|pattern|failure|decision> --description "..." --outcome-status success --outcome-agent ${config.agentName}\` — capture insights from your work`,
+		`${gateLines.length + 3}. **Signal completion:** send \`worker_done\` mail to ${config.parentAgent ?? "coordinator"}: \`ov mail send --to ${config.parentAgent ?? "coordinator"} --subject "Worker done: ${config.taskId}" --body "Quality gates passed." --type worker_done --agent ${config.agentName}\``,
 		`${gateLines.length + 4}. **Close issue:** \`${config.trackerCli ?? "bd"} close ${config.taskId} --reason "summary of changes"\``,
 		"",
 		"Do NOT push to the canonical branch. Your work will be merged by the",
-		"coordinator via `overstory merge`.",
+		"coordinator via `ov merge`.",
 	].join("\n");
 }
 
@@ -132,7 +132,7 @@ function formatConstraints(config: OverlayConfig): string {
 			"",
 			"- You are **read-only**: do NOT modify, create, or delete any files",
 			"- Do NOT commit, push, or make any git state changes",
-			`- Report completion via \`${config.trackerCli ?? "bd"} close\` AND \`overstory mail send --type result\``,
+			`- Report completion via \`${config.trackerCli ?? "bd"} close\` AND \`ov mail send --type result\``,
 			"- If you encounter a blocking issue, send mail with `--priority urgent --type error`",
 		].join("\n");
 	}
@@ -145,7 +145,7 @@ function formatConstraints(config: OverlayConfig): string {
 		"- Only modify files in your File Scope",
 		`- Commit only to your branch: ${config.branchName}`,
 		"- Never push to the canonical branch",
-		`- Report completion via \`${config.trackerCli ?? "bd"} close\` AND \`overstory mail send --type result\``,
+		`- Report completion via \`${config.trackerCli ?? "bd"} close\` AND \`ov mail send --type result\``,
 		"- If you encounter a blocking issue, send mail with `--priority urgent --type error`",
 	].join("\n");
 }
@@ -159,10 +159,10 @@ function formatCanSpawn(config: OverlayConfig): string {
 		return "You may NOT spawn sub-workers.";
 	}
 	return [
-		"You may spawn sub-workers using `overstory sling`. Example:",
+		"You may spawn sub-workers using `ov sling`. Example:",
 		"",
 		"```bash",
-		"overstory sling <task-id> --capability builder --name <worker-name> \\",
+		"ov sling <task-id> --capability builder --name <worker-name> \\",
 		`  --parent ${config.agentName} --depth ${config.depth + 1}`,
 		"```",
 	].join("\n");

package/src/commands/agents.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory agents <sub> [--json]
+ * CLI command: ov agents <sub> [--json]
  *
  * Discover and query agents by capability.
  */
@@ -8,6 +8,7 @@ import { join } from "node:path";
 import { Command } from "commander";
 import { loadConfig } from "../config.ts";
 import { ValidationError } from "../errors.ts";
+import { color } from "../logging/color.ts";
 import { openSessionStore } from "../sessions/compat.ts";
 import { type AgentSession, SUPPORTED_CAPABILITIES } from "../types.ts";
 
@@ -140,11 +141,11 @@ export async function discoverAgents(
 function getStateIcon(state: string): string {
 	switch (state) {
 		case "working":
-			return "●";
+			return color.cyan(">");
 		case "booting":
-			return "○";
+			return color.green("-");
 		case "stalled":
-			return "◌";
+			return color.yellow("!");
 		default:
 			return " ";
 	}
@@ -181,7 +182,7 @@ function printAgents(agents: DiscoveredAgent[]): void {
 }
 
 /**
- * Create the Commander command for `overstory agents`.
+ * Create the Commander command for `ov agents`.
  */
 export function createAgentsCommand(): Command {
 	const cmd = new Command("agents").description("Discover and query agents");
@@ -229,7 +230,7 @@ export function createAgentsCommand(): Command {
 }
 
 /**
- * Entry point for `overstory agents <subcommand>`.
+ * Entry point for `ov agents <subcommand>`.
  */
 export async function agentsCommand(args: string[]): Promise<void> {
 	const cmd = createAgentsCommand();

package/src/commands/clean.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory clean [--all] [--mail] [--sessions] [--metrics]
+ * CLI command: ov clean [--all] [--mail] [--sessions] [--metrics]
  *   [--logs] [--worktrees] [--branches] [--agents] [--specs]
  *
  * Nuclear cleanup of overstory runtime state.
@@ -394,7 +394,7 @@ async function checkMulchHealth(repoRoot: string): Promise<{
 }
 
 /**
- * Entry point for `overstory clean [flags]`.
+ * Entry point for `ov clean [flags]`.
  *
  * @param opts - Command options
  */
@@ -556,7 +556,7 @@ export async function cleanCommand(opts: CleanOptions): Promise<void> {
 		const healthLines: string[] = [];
 
 		if (health.domainsNearLimit.length > 0) {
-			healthLines.push("\n⚠️  Mulch domains approaching governance limits:");
+			healthLines.push("\nWarning: Mulch domains approaching governance limits:");
 			for (const d of health.domainsNearLimit) {
 				healthLines.push(
 					`   ${d.domain}: ${d.recordCount} records (warn threshold: ${d.warnThreshold})`,
@@ -566,13 +566,13 @@ export async function cleanCommand(opts: CleanOptions): Promise<void> {
 
 		if (health.stalePruneCandidates > 0) {
 			healthLines.push(
-				`\n📦 Stale records found: ${health.stalePruneCandidates} candidate${health.stalePruneCandidates === 1 ? "" : "s"} (run 'mulch prune' to remove)`,
+				`\nStale records found: ${health.stalePruneCandidates} candidate${health.stalePruneCandidates === 1 ? "" : "s"} (run 'mulch prune' to remove)`,
 			);
 		}
 
 		if (health.doctorWarnings > 0 || health.doctorIssues > 0) {
 			healthLines.push(
-				`\n🩺 Mulch health check: ${health.doctorWarnings} warning${health.doctorWarnings === 1 ? "" : "s"}, ${health.doctorIssues} issue${health.doctorIssues === 1 ? "" : "s"} (run 'mulch doctor' for details)`,
+				`\nMulch health check: ${health.doctorWarnings} warning${health.doctorWarnings === 1 ? "" : "s"}, ${health.doctorIssues} issue${health.doctorIssues === 1 ? "" : "s"} (run 'mulch doctor' for details)`,
 			);
 		}
 

package/src/commands/completions.test.ts

@@ -54,8 +54,8 @@ describe("COMMANDS array", () => {
 describe("generateBash", () => {
 	it("should return a bash completion script", () => {
 		const script = generateBash();
-		expect(script).toContain("_overstory()");
-		expect(script).toContain("complete -F _overstory overstory");
+		expect(script).toContain("_ov()");
+		expect(script).toContain("complete -F _ov ov");
 		expect(script).toContain("_init_completion");
 	});
 
@@ -87,8 +87,8 @@ describe("generateBash", () => {
 describe("generateZsh", () => {
 	it("should return a zsh completion script", () => {
 		const script = generateZsh();
-		expect(script).toContain("#compdef overstory");
-		expect(script).toContain("_overstory()");
+		expect(script).toContain("#compdef ov");
+		expect(script).toContain("_ov()");
 		expect(script).toContain("_describe");
 		expect(script).toContain("_arguments");
 	});
@@ -119,7 +119,7 @@ describe("generateZsh", () => {
 describe("generateFish", () => {
 	it("should return a fish completion script", () => {
 		const script = generateFish();
-		expect(script).toContain("complete -c overstory");
+		expect(script).toContain("complete -c ov");
 		expect(script).toContain("__fish_use_subcommand");
 	});
 
@@ -160,8 +160,8 @@ describe("completionsCommand", () => {
 
 		try {
 			completionsCommand(["bash"]);
-			expect(output).toContain("_overstory()");
-			expect(output).toContain("complete -F _overstory overstory");
+			expect(output).toContain("_ov()");
+			expect(output).toContain("complete -F _ov ov");
 		} finally {
 			process.stdout.write = originalWrite;
 		}
@@ -178,8 +178,8 @@ describe("completionsCommand", () => {
 
 		try {
 			completionsCommand(["zsh"]);
-			expect(output).toContain("#compdef overstory");
-			expect(output).toContain("_overstory()");
+			expect(output).toContain("#compdef ov");
+			expect(output).toContain("_ov()");
 		} finally {
 			process.stdout.write = originalWrite;
 		}
@@ -196,7 +196,7 @@ describe("completionsCommand", () => {
 
 		try {
 			completionsCommand(["fish"]);
-			expect(output).toContain("complete -c overstory");
+			expect(output).toContain("complete -c ov");
 		} finally {
 			process.stdout.write = originalWrite;
 		}

package/src/commands/completions.ts

@@ -609,11 +609,11 @@ export const COMMANDS: readonly CommandDef[] = [
 
 export function generateBash(): string {
 	const lines: string[] = [
-		"# Bash completion for overstory",
+		"# Bash completion for ov",
 		"# Source this file to enable completions:",
-		"#   source <(overstory --completions bash)",
+		"#   source <(ov --completions bash)",
 		"",
-		"_overstory() {",
+		"_ov() {",
 		"  local cur prev words cword",
 		"  _init_completion || return",
 		"",
@@ -668,19 +668,19 @@ export function generateBash(): string {
 	lines.push("  return 0");
 	lines.push("}");
 	lines.push("");
-	lines.push("complete -F _overstory overstory");
+	lines.push("complete -F _ov ov");
 
 	return lines.join("\n");
 }
 
 export function generateZsh(): string {
 	const lines: string[] = [
-		"#compdef overstory",
-		"# Zsh completion for overstory",
+		"#compdef ov",
+		"# Zsh completion for ov",
 		"# Place this file in your fpath or source it:",
-		"#   source <(overstory --completions zsh)",
+		"#   source <(ov --completions zsh)",
 		"",
-		"_overstory() {",
+		"_ov() {",
 		"  local -a commands",
 		"  commands=(",
 	];
@@ -778,24 +778,24 @@ export function generateZsh(): string {
 	lines.push("  esac");
 	lines.push("}");
 	lines.push("");
-	lines.push('_overstory "$@"');
+	lines.push('_ov "$@"');
 
 	return lines.join("\n");
 }
 
 export function generateFish(): string {
 	const lines: string[] = [
-		"# Fish completion for overstory",
-		"# Place this file in ~/.config/fish/completions/overstory.fish or source it:",
-		"#   overstory --completions fish | source",
+		"# Fish completion for ov",
+		"# Place this file in ~/.config/fish/completions/ov.fish or source it:",
+		"#   ov --completions fish | source",
 		"",
-		"# Remove all existing completions for overstory",
-		"complete -c overstory -e",
+		"# Remove all existing completions for ov",
+		"complete -c ov -e",
 		"",
 		"# Global options",
-		"complete -c overstory -l help -d 'Show help'",
-		"complete -c overstory -l version -d 'Show version'",
-		"complete -c overstory -l completions -d 'Generate shell completions' -xa 'bash zsh fish'",
+		"complete -c ov -l help -d 'Show help'",
+		"complete -c ov -l version -d 'Show version'",
+		"complete -c ov -l completions -d 'Generate shell completions' -xa 'bash zsh fish'",
 		"",
 	];
 
@@ -803,15 +803,13 @@ export function generateFish(): string {
 	for (const cmd of COMMANDS) {
 		// Command name
 		lines.push(`# ${cmd.desc}`);
-		lines.push(
-			`complete -c overstory -f -n '__fish_use_subcommand' -a '${cmd.name}' -d '${cmd.desc}'`,
-		);
+		lines.push(`complete -c ov -f -n '__fish_use_subcommand' -a '${cmd.name}' -d '${cmd.desc}'`);
 
 		if (cmd.subcommands && cmd.subcommands.length > 0) {
 			// Subcommand names
 			for (const subcmd of cmd.subcommands) {
 				lines.push(
-					`complete -c overstory -f -n '__fish_seen_subcommand_from ${cmd.name}; and not __fish_seen_subcommand_from ${cmd.subcommands.map((s) => s.name).join(" ")}' -a '${subcmd.name}' -d '${subcmd.desc}'`,
+					`complete -c ov -f -n '__fish_seen_subcommand_from ${cmd.name}; and not __fish_seen_subcommand_from ${cmd.subcommands.map((s) => s.name).join(" ")}' -a '${subcmd.name}' -d '${subcmd.desc}'`,
 				);
 
 				// Subcommand flags
@@ -822,12 +820,12 @@ export function generateFish(): string {
 
 						if (flag.values) {
 							lines.push(
-								`complete -c overstory -f -n ${cond} -l '${flagName}' -d '${flag.desc}' -xa '${flag.values.join(" ")}'`,
+								`complete -c ov -f -n ${cond} -l '${flagName}' -d '${flag.desc}' -xa '${flag.values.join(" ")}'`,
 							);
 						} else if (flag.takesValue) {
-							lines.push(`complete -c overstory -n ${cond} -l '${flagName}' -d '${flag.desc}'`);
+							lines.push(`complete -c ov -n ${cond} -l '${flagName}' -d '${flag.desc}'`);
 						} else {
-							lines.push(`complete -c overstory -f -n ${cond} -l '${flagName}' -d '${flag.desc}'`);
+							lines.push(`complete -c ov -f -n ${cond} -l '${flagName}' -d '${flag.desc}'`);
 						}
 					}
 				}
@@ -842,12 +840,12 @@ export function generateFish(): string {
 
 				if (flag.values) {
 					lines.push(
-						`complete -c overstory -f -n ${cond} -l '${flagName}' -d '${flag.desc}' -xa '${flag.values.join(" ")}'`,
+						`complete -c ov -f -n ${cond} -l '${flagName}' -d '${flag.desc}' -xa '${flag.values.join(" ")}'`,
 					);
 				} else if (flag.takesValue) {
-					lines.push(`complete -c overstory -n ${cond} -l '${flagName}' -d '${flag.desc}'`);
+					lines.push(`complete -c ov -n ${cond} -l '${flagName}' -d '${flag.desc}'`);
 				} else {
-					lines.push(`complete -c overstory -f -n ${cond} -l '${flagName}' -d '${flag.desc}'`);
+					lines.push(`complete -c ov -f -n ${cond} -l '${flagName}' -d '${flag.desc}'`);
 				}
 			}
 		}
@@ -875,7 +873,7 @@ export function completionsCommand(args: string[]): void {
 
 	if (!shell) {
 		process.stderr.write("Error: missing shell argument\n");
-		process.stderr.write("Usage: overstory --completions <bash|zsh|fish>\n");
+		process.stderr.write("Usage: ov --completions <bash|zsh|fish>\n");
 		process.exit(1);
 	}
 

package/src/commands/coordinator.test.ts

@@ -1025,9 +1025,9 @@ describe("buildCoordinatorBeacon", () => {
 	test("includes startup instructions", () => {
 		const beacon = buildCoordinatorBeacon();
 		expect(beacon).toContain("mulch prime");
-		expect(beacon).toContain("overstory mail check --agent coordinator");
+		expect(beacon).toContain("ov mail check --agent coordinator");
 		expect(beacon).toContain("bd ready");
-		expect(beacon).toContain("overstory group status");
+		expect(beacon).toContain("ov group status");
 	});
 
 	test("defaults to bd ready when no cliName provided", () => {

package/src/commands/coordinator.ts

@@ -1,9 +1,9 @@
 /**
- * CLI command: overstory coordinator start|stop|status
+ * CLI command: ov coordinator start|stop|status
  *
  * Manages the persistent coordinator agent lifecycle. The coordinator runs
  * at the project root (NOT in a worktree), receives work via mail and beads,
- * and dispatches agents via overstory sling.
+ * and dispatches agents via ov sling.
  *
  * Unlike regular agents spawned by sling, the coordinator:
  * - Has no worktree (operates on the main working tree)
@@ -115,7 +115,7 @@ async function removeWatchdogPid(projectRoot: string): Promise<void> {
 
 /**
  * Default watchdog implementation for production use.
- * Starts/stops the watchdog daemon via `overstory watch --background`.
+ * Starts/stops the watchdog daemon via `ov watch --background`.
  */
 function createDefaultWatchdog(projectRoot: string): NonNullable<CoordinatorDeps["_watchdog"]> {
 	return {
@@ -132,7 +132,7 @@ function createDefaultWatchdog(projectRoot: string): NonNullable<CoordinatorDeps
 			}
 
 			// Start watchdog in background
-			const proc = Bun.spawn(["overstory", "watch", "--background"], {
+			const proc = Bun.spawn(["ov", "watch", "--background"], {
 				cwd: projectRoot,
 				stdout: "pipe",
 				stderr: "pipe",
@@ -189,12 +189,12 @@ function createDefaultWatchdog(projectRoot: string): NonNullable<CoordinatorDeps
 
 /**
  * Default monitor implementation for production use.
- * Starts/stops the monitor agent via `overstory monitor start/stop`.
+ * Starts/stops the monitor agent via `ov monitor start/stop`.
  */
 function createDefaultMonitor(projectRoot: string): NonNullable<CoordinatorDeps["_monitor"]> {
 	return {
 		async start(): Promise<{ pid: number } | null> {
-			const proc = Bun.spawn(["overstory", "monitor", "start", "--no-attach", "--json"], {
+			const proc = Bun.spawn(["ov", "monitor", "start", "--no-attach", "--json"], {
 				cwd: projectRoot,
 				stdout: "pipe",
 				stderr: "pipe",
@@ -210,7 +210,7 @@ function createDefaultMonitor(projectRoot: string): NonNullable<CoordinatorDeps[
 			}
 		},
 		async stop(): Promise<boolean> {
-			const proc = Bun.spawn(["overstory", "monitor", "stop", "--json"], {
+			const proc = Bun.spawn(["ov", "monitor", "stop", "--json"], {
 				cwd: projectRoot,
 				stdout: "pipe",
 				stderr: "pipe",
@@ -219,7 +219,7 @@ function createDefaultMonitor(projectRoot: string): NonNullable<CoordinatorDeps[
 			return exitCode === 0;
 		},
 		async isRunning(): Promise<boolean> {
-			const proc = Bun.spawn(["overstory", "monitor", "status", "--json"], {
+			const proc = Bun.spawn(["ov", "monitor", "status", "--json"], {
 				cwd: projectRoot,
 				stdout: "pipe",
 				stderr: "pipe",
@@ -248,9 +248,9 @@ export function buildCoordinatorBeacon(cliName = "bd"): string {
 	const parts = [
 		`[OVERSTORY] ${COORDINATOR_NAME} (coordinator) ${timestamp}`,
 		"Depth: 0 | Parent: none | Role: persistent orchestrator",
-		"HIERARCHY: You ONLY spawn leads (overstory sling --capability lead). Leads spawn scouts, builders, reviewers. NEVER spawn non-lead agents directly.",
+		"HIERARCHY: You ONLY spawn leads (ov sling --capability lead). Leads spawn scouts, builders, reviewers. NEVER spawn non-lead agents directly.",
 		"DELEGATION: For any exploration/scouting, spawn a lead who will spawn scouts. Do NOT explore the codebase yourself beyond initial planning.",
-		`Startup: run mulch prime, check mail (overstory mail check --agent ${COORDINATOR_NAME}), check ${cliName} ready, check overstory group status, then begin work`,
+		`Startup: run mulch prime, check mail (ov mail check --agent ${COORDINATOR_NAME}), check ${cliName} ready, check ov group status, then begin work`,
 	];
 	return parts.join(" — ");
 }
@@ -686,7 +686,7 @@ async function statusCoordinator(
 }
 
 /**
- * Create the Commander command for `overstory coordinator`.
+ * Create the Commander command for `ov coordinator`.
  */
 export function createCoordinatorCommand(deps: CoordinatorDeps = {}): Command {
 	const cmd = new Command("coordinator").description("Manage the persistent coordinator agent");
@@ -735,7 +735,7 @@ export function createCoordinatorCommand(deps: CoordinatorDeps = {}): Command {
 }
 
 /**
- * Entry point for `overstory coordinator <subcommand>`.
+ * Entry point for `ov coordinator <subcommand>`.
  *
  * @param args - CLI arguments after "coordinator"
  * @param deps - Optional dependency injection for testing (tmux)

package/src/commands/costs.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory costs [--agent <name>] [--run <id>] [--by-capability] [--last <n>] [--self] [--json]
+ * CLI command: ov costs [--agent <name>] [--run <id>] [--by-capability] [--last <n>] [--self] [--json]
  *
  * Shows token/cost analysis and breakdown for agent sessions.
  * Data source: metrics.db via createMetricsStore().

package/src/commands/dashboard.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory dashboard [--interval <ms>] [--all]
+ * CLI command: ov dashboard [--interval <ms>] [--all]
  *
  * Rich terminal dashboard using raw ANSI escape codes (zero runtime deps).
  * Polls existing data sources and renders multi-panel layout with agent status,
@@ -402,7 +402,7 @@ async function loadDashboardData(
  * Render the header bar (line 1).
  */
 function renderHeader(width: number, interval: number, currentRunId?: string | null): string {
-	const left = color.bold(`overstory dashboard v${PKG_VERSION}`);
+	const left = color.bold(`ov dashboard v${PKG_VERSION}`);
 	const now = new Date().toLocaleTimeString();
 	const scope = currentRunId ? ` [run: ${currentRunId.slice(0, 8)}]` : " [all runs]";
 	const right = `${now}${scope} | refresh: ${interval}ms`;
@@ -438,15 +438,15 @@ function getStateColor(state: string): ColorFn {
 function getStateIcon(state: string): string {
 	switch (state) {
 		case "working":
-			return "●";
+			return ">";
 		case "booting":
-			return "◐";
+			return "-";
 		case "stalled":
-			return "⚠";
+			return "!";
 		case "zombie":
-			return "○";
+			return "x";
 		case "completed":
-			return "✓";
+			return "x";
 		default:
 			return "?";
 	}
@@ -508,7 +508,7 @@ function renderAgentPanel(
 		const duration = formatDuration(endTime - new Date(agent.startedAt).getTime());
 		const durationPadded = pad(duration, 9);
 		const tmuxAlive = data.status.tmuxSessions.some((s) => s.name === agent.tmuxSession);
-		const tmuxDot = tmuxAlive ? color.green("●") : color.red("○");
+		const tmuxDot = tmuxAlive ? color.green(">") : color.red("x");
 
 		const line = `${BOX.vertical} ${stateColor(icon)}  ${name} ${capability} ${stateColor(state)} ${taskId} ${durationPadded} ${tmuxDot}    ${BOX.vertical}`;
 		output += `${CURSOR.cursorTo(startRow + 3 + i, 1)}${line}\n`;

package/src/commands/doctor.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory doctor [options]
+ * CLI command: ov doctor [options]
  *
  * Runs health checks on overstory subsystems and reports problems.
  */
@@ -77,10 +77,10 @@ function printHumanReadable(
 
 				const icon =
 					check.status === "pass"
-						? color.green("✔")
+						? color.green("-")
 						: check.status === "warn"
-							? color.yellow("⚠")
-							: color.red("✘");
+							? color.yellow("!")
+							: color.red("x");
 
 				w(`  ${icon} ${check.message}\n`);
 

package/src/commands/errors.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory errors [--agent <name>] [--run <id>] [--json] [--since <ts>] [--until <ts>] [--limit <n>]
+ * CLI command: ov errors [--agent <name>] [--run <id>] [--json] [--since <ts>] [--until <ts>] [--limit <n>]
  *
  * Shows aggregated error-level events across all agents.
  * Errors can be filtered by agent name, run ID, or time range.

package/src/commands/feed.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory feed [--follow] [--agent <name>...] [--run <id>]
+ * CLI command: ov feed [--follow] [--agent <name>...] [--run <id>]
  *              [--since <ts>] [--limit <n>] [--interval <ms>] [--json]
  *
  * Unified real-time event stream across all agents — like `tail -f` for the fleet.

package/src/commands/group.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory group create|status|add|remove|list
+ * CLI command: ov group create|status|add|remove|list
  *
  * Manages TaskGroups for batch work coordination. Groups track collections
  * of beads issues and auto-close when all member issues are closed.
@@ -297,7 +297,7 @@ function printGroupProgress(progress: TaskGroupProgress): void {
 }
 
 /**
- * Create the Commander command for `overstory group`.
+ * Create the Commander command for `ov group`.
  */
 export function createGroupCommand(): Command {
 	const cmd = new Command("group").description("Manage task groups for batch coordination");
@@ -472,7 +472,7 @@ export function createGroupCommand(): Command {
 }
 
 /**
- * Entry point for `overstory group <subcommand>`.
+ * Entry point for `ov group <subcommand>`.
  */
 export async function groupCommand(args: string[]): Promise<void> {
 	const cmd = createGroupCommand();