@os-eco/overstory-cli 0.6.5 → 0.6.6

package/src/commands/hooks.test.ts

@@ -22,13 +22,13 @@ const SAMPLE_HOOKS = {
 		SessionStart: [
 			{
 				matcher: "",
-				hooks: [{ type: "command", command: "overstory prime --agent orchestrator" }],
+				hooks: [{ type: "command", command: "ov prime --agent orchestrator" }],
 			},
 		],
 		Stop: [
 			{
 				matcher: "",
-				hooks: [{ type: "command", command: "overstory log session-end --agent orchestrator" }],
+				hooks: [{ type: "command", command: "ov log session-end --agent orchestrator" }],
 			},
 		],
 	},
@@ -106,7 +106,7 @@ describe("hooks install", () => {
 		const content = await Bun.file(targetPath).text();
 		const parsed = JSON.parse(content) as Record<string, unknown>;
 		expect(parsed.hooks).toBeDefined();
-		expect(content).toContain("overstory prime");
+		expect(content).toContain("ov prime");
 	});
 
 	test("preserves existing non-hooks keys in settings.local.json", async () => {
@@ -182,7 +182,7 @@ describe("hooks install", () => {
 		// Existing user hook is preserved
 		expect(content).toContain("user-hook");
 		// Overstory hooks are added
-		expect(content).toContain("overstory prime");
+		expect(content).toContain("ov prime");
 	});
 
 	test("throws when .overstory/hooks.json does not exist", async () => {
@@ -284,7 +284,7 @@ describe("hooks install merge behavior", () => {
 		// User's PreToolUse hook preserved
 		expect(content).toContain("user-write-hook");
 		// Overstory's SessionStart hook added
-		expect(content).toContain("overstory prime");
+		expect(content).toContain("ov prime");
 		// Both event types present
 		expect(parsed.hooks.PreToolUse).toBeDefined();
 		expect(parsed.hooks.SessionStart).toBeDefined();
@@ -361,7 +361,7 @@ describe("hooks install merge behavior", () => {
 		const parsed = JSON.parse(content) as { hooks: Record<string, unknown[]> };
 		expect(parsed.hooks.SessionStart).toBeDefined();
 		expect(parsed.hooks.Stop).toBeDefined();
-		expect(content).toContain("overstory prime");
+		expect(content).toContain("ov prime");
 	});
 
 	describe("mergeHooksByEventType unit tests", () => {
@@ -424,7 +424,7 @@ describe("hooks status", () => {
 		const output = await captureStdout(() => hooksCommand(["status"]));
 		expect(output).toContain("present");
 		expect(output).toContain("no");
-		expect(output).toContain("overstory hooks install");
+		expect(output).toContain("ov hooks install");
 	});
 
 	test("reports installed:true when hooks present in .claude/", async () => {

package/src/commands/hooks.ts

@@ -1,13 +1,13 @@
 /**
- * CLI command: overstory hooks install|uninstall|status
+ * CLI command: ov hooks install|uninstall|status
  *
  * Manages orchestrator hooks in .claude/settings.local.json.
- * Hooks are sourced from .overstory/hooks.json (generated by overstory init).
+ * Hooks are sourced from .overstory/hooks.json (generated by ov init).
  *
  * This keeps the canonical hook configuration in .overstory/ while placing
  * a minimal copy in .claude/ only when the user explicitly opts in.
- * Running `overstory init` alone does NOT modify .claude/ — the user must
- * run `overstory hooks install` as a separate step.
+ * Running `ov init` alone does NOT modify .claude/ — the user must
+ * run `ov hooks install` as a separate step.
  */
 
 import { mkdir, unlink } from "node:fs/promises";
@@ -80,7 +80,7 @@ async function installHooks(force: boolean): Promise<void> {
 	const sourcePath = join(projectRoot, ".overstory", "hooks.json");
 	const sourceFile = Bun.file(sourcePath);
 	if (!(await sourceFile.exists())) {
-		throw new ValidationError("No hooks.json found in .overstory/. Run 'overstory init' first.", {
+		throw new ValidationError("No hooks.json found in .overstory/. Run 'ov init' first.", {
 			field: "source",
 		});
 	}
@@ -199,7 +199,7 @@ async function statusHooks(json: boolean): Promise<void> {
 			`Hooks installed (.claude/settings.local.json): ${installed ? "yes" : "no"}\n`,
 		);
 		if (!installed && sourceExists) {
-			process.stdout.write(`\nRun 'overstory hooks install' to install.\n`);
+			process.stdout.write(`\nRun 'ov hooks install' to install.\n`);
 		}
 	}
 }
@@ -234,7 +234,7 @@ export function createHooksCommand(): Command {
 }
 
 /**
- * Entry point for `overstory hooks <subcommand>`.
+ * Entry point for `ov hooks <subcommand>`.
  */
 export async function hooksCommand(args: string[]): Promise<void> {
 	const cmd = createHooksCommand();

package/src/commands/init.test.ts

@@ -20,6 +20,10 @@ const AGENT_DEF_FILES = [
 	"supervisor.md",
 	"coordinator.md",
 	"monitor.md",
+	"issue-reviews.md",
+	"pr-reviews.md",
+	"prioritize.md",
+	"release.md",
 ];
 
 /** Resolve the source agents directory (same logic as init.ts). */
@@ -46,7 +50,7 @@ describe("initCommand: agent-defs deployment", () => {
 		await cleanupTempDir(tempDir);
 	});
 
-	test("creates .overstory/agent-defs/ with all 8 agent definition files", async () => {
+	test("creates .overstory/agent-defs/ with all 12 agent definition files", async () => {
 		await initCommand({});
 
 		const agentDefsDir = join(tempDir, ".overstory", "agent-defs");
@@ -100,7 +104,7 @@ describe("initCommand: agent-defs deployment", () => {
 		const stopHooks = parsed.hooks.Stop[0].hooks;
 
 		expect(stopHooks.length).toBe(2);
-		expect(stopHooks[0].command).toContain("overstory log session-end");
+		expect(stopHooks[0].command).toContain("ov log session-end");
 		expect(stopHooks[1].command).toBe("mulch learn");
 	});
 

package/src/commands/init.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory init [--force]
+ * CLI command: ov init [--force]
  *
  * Scaffolds the `.overstory/` directory in the current project with:
  * - config.yaml (serialized from DEFAULT_CONFIG)
@@ -296,7 +296,7 @@ function buildHooksJson(): string {
 					hooks: [
 						{
 							type: "command",
-							command: "overstory prime --agent orchestrator",
+							command: "ov prime --agent orchestrator",
 						},
 					],
 				},
@@ -307,7 +307,7 @@ function buildHooksJson(): string {
 					hooks: [
 						{
 							type: "command",
-							command: "overstory mail check --inject --agent orchestrator",
+							command: "ov mail check --inject --agent orchestrator",
 						},
 					],
 				},
@@ -328,7 +328,7 @@ function buildHooksJson(): string {
 					hooks: [
 						{
 							type: "command",
-							command: `${toolNameExtract} overstory log tool-start --agent orchestrator --tool-name "$TOOL_NAME"`,
+							command: `${toolNameExtract} ov log tool-start --agent orchestrator --tool-name "$TOOL_NAME"`,
 						},
 					],
 				},
@@ -339,7 +339,7 @@ function buildHooksJson(): string {
 					hooks: [
 						{
 							type: "command",
-							command: `${toolNameExtract} overstory log tool-end --agent orchestrator --tool-name "$TOOL_NAME"`,
+							command: `${toolNameExtract} ov log tool-end --agent orchestrator --tool-name "$TOOL_NAME"`,
 						},
 					],
 				},
@@ -360,7 +360,7 @@ function buildHooksJson(): string {
 					hooks: [
 						{
 							type: "command",
-							command: "overstory log session-end --agent orchestrator",
+							command: "ov log session-end --agent orchestrator",
 						},
 						{
 							type: "command",
@@ -375,7 +375,7 @@ function buildHooksJson(): string {
 					hooks: [
 						{
 							type: "command",
-							command: "overstory prime --agent orchestrator --compact",
+							command: "ov prime --agent orchestrator --compact",
 						},
 					],
 				},
@@ -450,11 +450,11 @@ CREATE TABLE IF NOT EXISTS sessions (
 /**
  * Content for .overstory/.gitignore — runtime state that should not be tracked.
  * Uses wildcard+whitelist pattern: ignore everything, whitelist tracked files.
- * Auto-healed by overstory prime on each session start.
+ * Auto-healed by ov prime on each session start.
  * Config files (config.yaml, agent-manifest.json, hooks.json) remain tracked.
  */
 export const OVERSTORY_GITIGNORE = `# Wildcard+whitelist: ignore everything, whitelist tracked files
-# Auto-healed by overstory prime on each session start
+# Auto-healed by ov prime on each session start
 *
 !.gitignore
 !config.yaml
@@ -476,13 +476,13 @@ Overstory turns a single Claude Code session into a multi-agent team by spawning
 
 ## Key Commands
 
-- \`overstory init\`          — Initialize this directory
-- \`overstory status\`        — Show active agents and state
-- \`overstory sling <id>\`    — Spawn a worker agent
-- \`overstory mail check\`    — Check agent messages
-- \`overstory merge\`         — Merge agent work back
-- \`overstory dashboard\`     — Live TUI monitoring
-- \`overstory doctor\`        — Run health checks
+- \`ov init\`          — Initialize this directory
+- \`ov status\`        — Show active agents and state
+- \`ov sling <id>\`    — Spawn a worker agent
+- \`ov mail check\`    — Check agent messages
+- \`ov merge\`         — Merge agent work back
+- \`ov dashboard\`     — Live TUI monitoring
+- \`ov doctor\`        — Run health checks
 
 ## Structure
 
@@ -526,7 +526,7 @@ function printCreated(relativePath: string): void {
 }
 
 /**
- * Entry point for `overstory init [--force]`.
+ * Entry point for `ov init [--force]`.
  *
  * Scaffolds the .overstory/ directory structure in the current working directory.
  *
@@ -636,6 +636,6 @@ export async function initCommand(opts: InitOptions): Promise<void> {
 	}
 
 	process.stdout.write("\nDone.\n");
-	process.stdout.write("  Next: run `overstory hooks install` to enable Claude Code hooks.\n");
-	process.stdout.write("  Then: run `overstory status` to see the current state.\n");
+	process.stdout.write("  Next: run `ov hooks install` to enable Claude Code hooks.\n");
+	process.stdout.write("  Then: run `ov status` to see the current state.\n");
 }

package/src/commands/inspect.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory inspect <agent-name>
+ * CLI command: ov inspect <agent-name>
  *
  * Deep per-agent inspection aggregating data from EventStore, SessionStore,
  * MetricsStore, and tmux capture-pane.
@@ -35,15 +35,15 @@ function formatDuration(ms: number): string {
 function getStateIcon(state: AgentSession["state"]): string {
 	switch (state) {
 		case "booting":
-			return `${color.yellow("⏳")}`; // Yellow hourglass
+			return color.green("-");
 		case "working":
-			return `${color.green("●")}`; // Green circle
+			return color.cyan(">");
 		case "stalled":
-			return `${color.yellow("⚠")}`; // Yellow warning
+			return color.yellow("!");
 		case "completed":
-			return `${color.blue("✓")}`; // Blue checkmark
+			return color.dim("x");
 		case "zombie":
-			return `${color.red("☠")}`; // Red skull
+			return color.dim("x");
 		default:
 			return "?";
 	}
@@ -252,31 +252,31 @@ export function printInspectData(data: InspectData): void {
 	const w = process.stdout.write.bind(process.stdout);
 	const { session } = data;
 
-	w(`\n🔍 Agent Inspection: ${session.agentName}\n`);
+	w(`\nAgent Inspection: ${session.agentName}\n`);
 	w(`${"═".repeat(80)}\n\n`);
 
 	// Agent state and metadata
 	const stateIcon = getStateIcon(session.state);
 	w(`${stateIcon} State: ${session.state}\n`);
-	w(`⏱  Last activity: ${formatDuration(data.timeSinceLastActivity)} ago\n`);
-	w(`🎯 Task: ${session.taskId}\n`);
-	w(`🔧 Capability: ${session.capability}\n`);
-	w(`🌿 Branch: ${session.branchName}\n`);
+	w(`Last activity: ${formatDuration(data.timeSinceLastActivity)} ago\n`);
+	w(`Task: ${session.taskId}\n`);
+	w(`Capability: ${session.capability}\n`);
+	w(`Branch: ${session.branchName}\n`);
 	if (session.parentAgent) {
-		w(`👤 Parent: ${session.parentAgent} (depth: ${session.depth})\n`);
+		w(`Parent: ${session.parentAgent} (depth: ${session.depth})\n`);
 	}
-	w(`📅 Started: ${session.startedAt}\n`);
-	w(`💻 Tmux: ${session.tmuxSession}\n`);
+	w(`Started: ${session.startedAt}\n`);
+	w(`Tmux: ${session.tmuxSession}\n`);
 	w("\n");
 
 	// Current file
 	if (data.currentFile) {
-		w(`📝 Current file: ${data.currentFile}\n\n`);
+		w(`Current file: ${data.currentFile}\n\n`);
 	}
 
 	// Token usage
 	if (data.tokenUsage) {
-		w("💰 Token Usage\n");
+		w("Token Usage\n");
 		w(`${"─".repeat(80)}\n`);
 		w(`  Input:         ${data.tokenUsage.inputTokens.toLocaleString()}\n`);
 		w(`  Output:        ${data.tokenUsage.outputTokens.toLocaleString()}\n`);
@@ -293,7 +293,7 @@ export function printInspectData(data: InspectData): void {
 
 	// Tool usage statistics (top 10)
 	if (data.toolStats.length > 0) {
-		w("🛠  Tool Usage (Top 10)\n");
+		w("Tool Usage (Top 10)\n");
 		w(`${"─".repeat(80)}\n`);
 		const top10 = data.toolStats.slice(0, 10);
 		for (const stat of top10) {
@@ -306,7 +306,7 @@ export function printInspectData(data: InspectData): void {
 
 	// Recent tool calls
 	if (data.recentToolCalls.length > 0) {
-		w(`📊 Recent Tool Calls (last ${data.recentToolCalls.length})\n`);
+		w(`Recent Tool Calls (last ${data.recentToolCalls.length})\n`);
 		w(`${"─".repeat(80)}\n`);
 		for (const call of data.recentToolCalls) {
 			const time = new Date(call.timestamp).toLocaleTimeString();
@@ -322,7 +322,7 @@ export function printInspectData(data: InspectData): void {
 
 	// tmux output
 	if (data.tmuxOutput) {
-		w("📺 Live Tmux Output\n");
+		w("Live Tmux Output\n");
 		w(`${"─".repeat(80)}\n`);
 		w(`${data.tmuxOutput}\n`);
 		w(`${"─".repeat(80)}\n`);

package/src/commands/log.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory log <event> --agent <name> [--stdin]
+ * CLI command: ov log <event> --agent <name> [--stdin]
  *
  * Called by Pre/PostToolUse and Stop hooks.
  * Events: tool-start, tool-end, session-end.
@@ -542,7 +542,7 @@ async function runLog(opts: {
 				if (agentSession) {
 					// Auto-complete the current run when the coordinator exits.
 					// This handles the case where the user closes the tmux window
-					// without running `overstory coordinator stop`.
+					// without running `ov coordinator stop`.
 					if (agentSession.capability === "coordinator") {
 						try {
 							const currentRunPath = join(config.project.root, ".overstory", "current-run.txt");
@@ -710,7 +710,7 @@ export function createLogCommand(): Command {
 }
 
 /**
- * Entry point for `overstory log <event> --agent <name>`.
+ * Entry point for `ov log <event> --agent <name>`.
  */
 export async function logCommand(args: string[]): Promise<void> {
 	const cmd = createLogCommand();

package/src/commands/logs.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory logs [--agent <name>] [--level <level>] [--since <time>] [--until <time>] [--limit <n>] [--follow] [--json]
+ * CLI command: ov logs [--agent <name>] [--level <level>] [--since <time>] [--until <time>] [--limit <n>] [--follow] [--json]
  *
  * Queries NDJSON log files from .overstory/logs/{agent-name}/{session-timestamp}/events.ndjson
  * and presents a unified timeline view.

package/src/commands/mail.test.ts

@@ -1175,7 +1175,7 @@ describe("mailCommand", () => {
 			]);
 
 			// Verify warning on stderr
-			expect(stderrOutput).toContain("WARNING");
+			expect(stderrOutput).toContain("Warning:");
 			expect(stderrOutput).toContain("NO reviewer sessions found");
 			expect(stderrOutput).toContain("lead-1");
 			expect(stderrOutput).toContain("2 builder(s)");
@@ -1208,7 +1208,7 @@ describe("mailCommand", () => {
 			]);
 
 			// Verify note on stderr
-			expect(stderrOutput).toContain("NOTE");
+			expect(stderrOutput).toContain("Note:");
 			expect(stderrOutput).toContain("Only 1 reviewer(s) for 3 builder(s)");
 			expect(stderrOutput).toContain("review-verified");
 		});

package/src/commands/mail.ts

@@ -373,7 +373,7 @@ async function handleSend(opts: SendOpts, cwd: string): Promise<void> {
 				);
 			} else {
 				process.stdout.write(
-					`📢 Broadcast sent to ${recipients.length} recipient${recipients.length === 1 ? "" : "s"} (${to})\n`,
+					`Broadcast sent to ${recipients.length} recipient${recipients.length === 1 ? "" : "s"} (${to})\n`,
 				);
 				for (let i = 0; i < recipients.length; i++) {
 					const recipient = recipients[i];
@@ -429,7 +429,7 @@ async function handleSend(opts: SendOpts, cwd: string): Promise<void> {
 		if (opts.json) {
 			process.stdout.write(`${JSON.stringify({ id })}\n`);
 		} else {
-			process.stdout.write(`✉️  Sent message ${id} to ${to}\n`);
+			process.stdout.write(`Sent message ${id} to ${to}\n`);
 		}
 
 		// Auto-nudge: write a pending nudge marker instead of sending tmux keys.
@@ -449,11 +449,28 @@ async function handleSend(opts: SendOpts, cwd: string): Promise<void> {
 			});
 			if (!opts.json) {
 				process.stdout.write(
-					`📢 Queued nudge for "${to}" (${nudgeReason}, delivered on next prompt)\n`,
+					`Queued nudge for "${to}" (${nudgeReason}, delivered on next prompt)\n`,
 				);
 			}
 		}
 
+		// For dispatch messages, also send an immediate tmux nudge.
+		// Dispatch targets newly spawned agents that may be idle at the welcome
+		// screen where file-based nudges can't reach (no hook fires on idle agents).
+		// The I/O corruption concern (overstory-ii1o) only applies during active
+		// tool execution — newly spawned agents are idle, so sendKeys is safe.
+		if (type === "dispatch") {
+			try {
+				const { nudgeAgent } = await import("./nudge.ts");
+				const nudgeMessage = `[DISPATCH] ${subject}: ${body.slice(0, 500)}`;
+				// Small delay to let the agent's TUI stabilize after sling
+				await Bun.sleep(3_000);
+				await nudgeAgent(cwd, to, nudgeMessage, true); // force=true to skip debounce
+			} catch {
+				// Non-fatal: the file-based nudge is the fallback
+			}
+		}
+
 		// Reviewer coverage check for merge_ready (advisory warning)
 		if (type === "merge_ready") {
 			try {
@@ -469,13 +486,13 @@ async function handleSend(opts: SendOpts, cwd: string): Promise<void> {
 					);
 					if (myBuilders.length > 0 && myReviewers.length === 0) {
 						process.stderr.write(
-							`\n⚠️  WARNING: merge_ready sent but NO reviewer sessions found for "${from}".\n` +
-								`⚠️  ${myBuilders.length} builder(s) completed without review. This violates the review-before-merge requirement.\n` +
-								`⚠️  Spawn reviewers for each builder before merge. See REVIEW_SKIP in agents/lead.md.\n\n`,
+							`\nWarning: merge_ready sent but NO reviewer sessions found for "${from}".\n` +
+								`${myBuilders.length} builder(s) completed without review. This violates the review-before-merge requirement.\n` +
+								`Spawn reviewers for each builder before merge. See REVIEW_SKIP in agents/lead.md.\n\n`,
 						);
 					} else if (myReviewers.length > 0 && myReviewers.length < myBuilders.length) {
 						process.stderr.write(
-							`\n⚠️  NOTE: Only ${myReviewers.length} reviewer(s) for ${myBuilders.length} builder(s). Ensure all builder work is review-verified.\n\n`,
+							`\nNote: Only ${myReviewers.length} reviewer(s) for ${myBuilders.length} builder(s). Ensure all builder work is review-verified.\n\n`,
 						);
 					}
 				} finally {
@@ -528,7 +545,7 @@ async function handleCheck(opts: CheckOpts, cwd: string): Promise<void> {
 
 			// Prepend a priority banner if there's a pending nudge
 			if (pendingNudge) {
-				const banner = `🚨 PRIORITY: ${pendingNudge.reason} message from ${pendingNudge.from} — "${pendingNudge.subject}"\n\n`;
+				const banner = `PRIORITY: ${pendingNudge.reason} message from ${pendingNudge.from} — "${pendingNudge.subject}"\n\n`;
 				process.stdout.write(banner);
 			}
 
@@ -544,7 +561,7 @@ async function handleCheck(opts: CheckOpts, cwd: string): Promise<void> {
 				process.stdout.write("No new messages.\n");
 			} else {
 				process.stdout.write(
-					`📬 ${messages.length} new message${messages.length === 1 ? "" : "s"}:\n\n`,
+					`${messages.length} new message${messages.length === 1 ? "" : "s"}:\n\n`,
 				);
 				for (const msg of messages) {
 					process.stdout.write(`${formatMessage(msg)}\n\n`);
@@ -617,7 +634,7 @@ function handleReply(id: string, opts: ReplyOpts, cwd: string): void {
 		if (opts.json) {
 			process.stdout.write(`${JSON.stringify({ id: replyId })}\n`);
 		} else {
-			process.stdout.write(`✉️  Reply sent: ${replyId}\n`);
+			process.stdout.write(`Reply sent: ${replyId}\n`);
 		}
 	} finally {
 		client.close();
@@ -677,7 +694,7 @@ export async function mailCommand(args: string[]): Promise<void> {
 	const root = await resolveProjectRoot(process.cwd());
 
 	const program = new Command();
-	program.name("overstory mail").description("Agent messaging system").exitOverride();
+	program.name("ov mail").description("Agent messaging system").exitOverride();
 
 	program
 		.command("send")

package/src/commands/merge.ts

@@ -1,14 +1,14 @@
 /**
- * CLI command: overstory merge
+ * CLI command: ov merge
  *
  * Merges agent branches back to the canonical branch using
  * the merge queue and tiered conflict resolver.
  *
  * Usage:
- *   overstory merge --branch <name>   Merge a specific branch
- *   overstory merge --all             Merge all pending branches
- *   overstory merge --dry-run         Check for conflicts without merging
- *   overstory merge --json            Output results as JSON
+ *   ov merge --branch <name>   Merge a specific branch
+ *   ov merge --all             Merge all pending branches
+ *   ov merge --dry-run         Check for conflicts without merging
+ *   ov merge --json            Output results as JSON
  */
 
 import { join } from "node:path";
@@ -124,7 +124,7 @@ function formatDryRun(entry: MergeEntry): string {
 }
 
 /**
- * Entry point for `overstory merge [flags]`.
+ * Entry point for `ov merge [flags]`.
  *
  * @param opts - Command options
  */
@@ -136,7 +136,7 @@ export async function mergeCommand(opts: MergeOptions): Promise<void> {
 	const json = opts.json ?? false;
 
 	if (!branchName && !all) {
-		throw new ValidationError("Either --branch <name> or --all is required for overstory merge", {
+		throw new ValidationError("Either --branch <name> or --all is required for ov merge", {
 			field: "branch|all",
 		});
 	}

package/src/commands/metrics.test.ts

@@ -151,7 +151,7 @@ describe("metricsCommand", () => {
 		const out = output();
 
 		// Check summary stats
-		expect(out).toContain("📈 Session Metrics");
+		expect(out).toContain("Session Metrics");
 		expect(out).toContain("Total sessions: 3");
 		expect(out).toContain("Completed: 2");
 		expect(out).toContain("Avg duration:");

package/src/commands/metrics.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory metrics [--last <n>] [--json]
+ * CLI command: ov metrics [--last <n>] [--json]
  *
  * Shows metrics summary from SQLite store: session durations, success rates,
  * merge tier distribution, agent utilization.
@@ -63,7 +63,7 @@ async function executeMetrics(opts: MetricsOpts): Promise<void> {
 			return;
 		}
 
-		process.stdout.write("📈 Session Metrics\n");
+		process.stdout.write("Session Metrics\n");
 		process.stdout.write(`${"═".repeat(60)}\n\n`);
 
 		// Summary stats

package/src/commands/monitor.test.ts

@@ -39,14 +39,14 @@ describe("buildMonitorBeacon", () => {
 		expect(beacon).toContain("mulch prime");
 	});
 
-	test("contains startup instruction: overstory status --json", () => {
+	test("contains startup instruction: ov status --json", () => {
 		const beacon = buildMonitorBeacon();
-		expect(beacon).toContain("overstory status --json");
+		expect(beacon).toContain("ov status --json");
 	});
 
-	test("contains startup instruction: overstory mail check --agent monitor", () => {
+	test("contains startup instruction: ov mail check --agent monitor", () => {
 		const beacon = buildMonitorBeacon();
-		expect(beacon).toContain("overstory mail check --agent monitor");
+		expect(beacon).toContain("ov mail check --agent monitor");
 	});
 
 	test("contains startup instruction: patrol loop", () => {
@@ -86,7 +86,7 @@ describe("monitorCommand", () => {
 		stdoutSpy.mockRestore();
 	});
 
-	test("--help prints help text containing 'overstory monitor'", async () => {
+	test("--help prints help text containing 'monitor'", async () => {
 		await monitorCommand(["--help"]);
 		const output = stdoutWrites.join("");
 		expect(output).toContain("monitor");

package/src/commands/monitor.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory monitor start|stop|status
+ * CLI command: ov monitor start|stop|status
  *
  * Manages the persistent Tier 2 monitor agent lifecycle. The monitor runs
  * at the project root (NOT in a worktree), continuously patrols the agent
@@ -9,7 +9,7 @@
  * Unlike regular agents spawned by sling, the monitor:
  * - Has no worktree (operates on the main working tree)
  * - Has no bead assignment (it monitors, not implements)
- * - Has no overlay CLAUDE.md (context comes via overstory status + mail)
+ * - Has no overlay CLAUDE.md (context comes via ov status + mail)
  * - Persists across patrol cycles
  */
 
@@ -46,7 +46,7 @@ export function buildMonitorBeacon(): string {
 	const parts = [
 		`[OVERSTORY] ${MONITOR_NAME} (monitor/tier-2) ${timestamp}`,
 		"Depth: 0 | Parent: none | Role: continuous fleet patrol",
-		`Startup: run mulch prime, check fleet (overstory status --json), check mail (overstory mail check --agent ${MONITOR_NAME}), then begin patrol loop`,
+		`Startup: run mulch prime, check fleet (ov status --json), check mail (ov mail check --agent ${MONITOR_NAME}), then begin patrol loop`,
 	];
 	return parts.join(" — ");
 }
@@ -356,7 +356,7 @@ export function createMonitorCommand(): Command {
 }
 
 /**
- * Entry point for `overstory monitor <subcommand>`.
+ * Entry point for `ov monitor <subcommand>`.
  */
 export async function monitorCommand(args: string[]): Promise<void> {
 	const cmd = createMonitorCommand();

package/src/commands/nudge.ts

@@ -283,7 +283,7 @@ export async function nudgeAgent(
 export async function nudgeCommand(args: string[]): Promise<void> {
 	const program = new Command();
 	program
-		.name("overstory nudge")
+		.name("ov nudge")
 		.description("Send a text nudge to an agent")
 		.argument("<agent-name>", "Name of the agent to nudge")
 		.argument("[message...]", "Text to send (default: check mail prompt)")

package/src/commands/prime.test.ts

@@ -361,7 +361,7 @@ recentTasks: []
 
 	describe("Gitignore auto-heal", () => {
 		const expectedGitignore = `# Wildcard+whitelist: ignore everything, whitelist tracked files
-# Auto-healed by overstory prime on each session start
+# Auto-healed by ov prime on each session start
 *
 !.gitignore
 !config.yaml

package/src/commands/prime.ts

@@ -1,5 +1,5 @@
 /**
- * `overstory prime` command.
+ * `ov prime` command.
  *
  * Loads context for the orchestrator or a specific agent and outputs it
  * to stdout for injection into Claude Code's context via hooks.
@@ -24,7 +24,7 @@ import { getCurrentSessionName } from "../worktree/tmux.ts";
  * Wildcard+whitelist pattern: ignore everything except tracked config files.
  */
 const OVERSTORY_GITIGNORE = `# Wildcard+whitelist: ignore everything, whitelist tracked files
-# Auto-healed by overstory prime on each session start
+# Auto-healed by ov prime on each session start
 *
 !.gitignore
 !config.yaml