@os-eco/overstory-cli 0.6.5 → 0.6.6

package/src/doctor/dependencies.test.ts

@@ -66,7 +66,7 @@ describe("checkDependencies", () => {
 		expect(toolNames).toContain("tmux availability");
 		expect(toolNames).toContain("sd availability");
 		expect(toolNames).toContain("mulch availability");
-		expect(toolNames).toContain("overstory availability");
+		expect(toolNames).toContain("ov availability");
 		expect(toolNames).toContain("cn availability");
 	});
 
@@ -201,9 +201,9 @@ describe("checkDependencies", () => {
 			expect(mlAlias?.category).toBe("dependencies");
 			expect(["pass", "warn"]).toContain(mlAlias?.status ?? "");
 		}
-		const ovCheck = checks.find((c) => c.name === "overstory availability");
+		const ovCheck = checks.find((c) => c.name === "ov availability");
 		if (ovCheck?.status === "pass") {
-			const ovAlias = checks.find((c) => c.name === "ov alias");
+			const ovAlias = checks.find((c) => c.name === "overstory alias");
 			expect(ovAlias).toBeDefined();
 			expect(["pass", "warn"]).toContain(ovAlias?.status ?? "");
 		}
@@ -229,9 +229,9 @@ describe("checkDependencies", () => {
 		}
 	});
 
-	test("includes overstory availability check", async () => {
+	test("includes ov availability check", async () => {
 		const checks = await checkDependencies(mockConfig, "/tmp/.overstory");
-		const ovCheck = checks.find((c) => c.name === "overstory availability");
+		const ovCheck = checks.find((c) => c.name === "ov availability");
 		expect(ovCheck).toBeDefined();
 		expect(ovCheck?.category).toBe("dependencies");
 	});

package/src/doctor/dependencies.ts

@@ -42,10 +42,10 @@ export const checkDependencies: DoctorCheckFn = async (
 			installHint: "@os-eco/mulch-cli",
 		},
 		{
-			name: "overstory",
+			name: "ov",
 			versionFlag: "--version",
 			required: true,
-			alias: "ov",
+			alias: "overstory",
 			installHint: "@os-eco/overstory-cli",
 		},
 		{

package/src/doctor/logs.ts

@@ -177,7 +177,7 @@ export const checkLogs: DoctorCheckFn = async (_config, overstoryDir): Promise<D
 			totalBytes > DISK_USAGE_WARN_THRESHOLD
 				? [
 						`Exceeds ${formatBytes(DISK_USAGE_WARN_THRESHOLD)} threshold`,
-						"Consider running 'overstory worktree clean --completed' to remove old logs",
+						"Consider running 'ov worktree clean --completed' to remove old logs",
 					]
 				: undefined,
 		fixable: totalBytes > DISK_USAGE_WARN_THRESHOLD,

package/src/doctor/structure.test.ts

@@ -104,7 +104,7 @@ describe("checkStructure", () => {
 		await Bun.write(
 			join(overstoryDir, ".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

package/src/doctor/structure.ts

@@ -32,7 +32,7 @@ export const checkStructure: DoctorCheckFn = async (
 		category: "structure",
 		status: overstoryDirExists ? "pass" : "fail",
 		message: overstoryDirExists ? "Directory exists" : "Directory missing",
-		details: overstoryDirExists ? undefined : ["Run 'overstory init' to create it"],
+		details: overstoryDirExists ? undefined : ["Run 'ov init' to create it"],
 		fixable: !overstoryDirExists,
 	});
 

package/src/doctor/version.test.ts

@@ -70,7 +70,7 @@ describe("checkVersion", () => {
 		const versionCheck = checks.find((c) => c.name === "version-current");
 		expect(versionCheck).toBeDefined();
 		expect(versionCheck?.status).toBeOneOf(["pass", "warn", "fail"]);
-		expect(versionCheck?.message).toContain("overstory");
+		expect(versionCheck?.message).toContain("ov");
 	});
 
 	test("includes package-json-sync check", async () => {
@@ -88,8 +88,8 @@ describe("checkVersion", () => {
 		expect(versionCheck).toBeDefined();
 
 		if (versionCheck?.status === "pass") {
-			// Message should contain version in format "overstory vX.Y.Z"
-			expect(versionCheck.message).toMatch(/overstory v\d+\.\d+\.\d+/);
+			// Message should contain version in format "ov vX.Y.Z"
+			expect(versionCheck.message).toMatch(/ov v\d+\.\d+\.\d+/);
 		}
 	});
 

package/src/doctor/version.ts

@@ -47,7 +47,7 @@ async function checkCurrentVersion(toolRoot: string): Promise<DoctorCheck> {
 			name: "version-current",
 			category: "version",
 			status: "pass",
-			message: `overstory v${packageJson.version}`,
+			message: `ov v${packageJson.version}`,
 		};
 	} catch (error) {
 		return {

package/src/e2e/init-sling-lifecycle.test.ts

@@ -22,9 +22,13 @@ import type { OverlayConfig } from "../types.ts";
 const EXPECTED_AGENT_DEFS = [
 	"builder.md",
 	"coordinator.md",
+	"issue-reviews.md",
 	"lead.md",
 	"merger.md",
 	"monitor.md",
+	"pr-reviews.md",
+	"prioritize.md",
+	"release.md",
 	"reviewer.md",
 	"scout.md",
 	"supervisor.md",
@@ -109,7 +113,7 @@ describe("E2E: init→sling lifecycle on external project", () => {
 		expect(config.project.name).toBeTruthy();
 	});
 
-	test("manifest loads successfully with all 8 agents", async () => {
+	test("manifest loads successfully with all 12 agents", async () => {
 		await initCommand({});
 
 		const manifestPath = join(tempDir, ".overstory", "agent-manifest.json");
@@ -269,7 +273,7 @@ describe("E2E: init→sling lifecycle on external project", () => {
 		expect(overlayContent).toContain("orchestrator");
 		expect(overlayContent).toContain("`src/main.ts`");
 		expect(overlayContent).toContain("`src/utils.ts`");
-		expect(overlayContent).toContain("mulch prime typescript");
+		expect(overlayContent).toContain("ml prime typescript");
 
 		// No unresolved placeholders
 		expect(overlayContent).not.toMatch(/\{\{[A-Z_]+\}\}/);

package/src/index.ts

@@ -4,7 +4,7 @@
  * Overstory CLI — main entry point and command router.
  *
  * Routes subcommands to their respective handlers in src/commands/.
- * Usage: overstory <command> [args...]
+ * Usage: ov <command> [args...]
  */
 
 import { Command } from "commander";
@@ -42,7 +42,7 @@ import { createWorktreeCommand } from "./commands/worktree.ts";
 import { OverstoryError, WorktreeError } from "./errors.ts";
 import { setQuiet } from "./logging/color.ts";
 
-const VERSION = "0.6.5";
+const VERSION = "0.6.6";
 
 const COMMANDS = [
 	"agents",
@@ -113,9 +113,9 @@ function suggestCommand(input: string): string | undefined {
 const program = new Command();
 
 program
-	.name("overstory")
+	.name("ov")
 	.description("Multi-agent orchestration for Claude Code")
-	.version(`overstory v${VERSION}`, "-v, --version")
+	.version(`ov v${VERSION}`, "-v, --version")
 	.option("-q, --quiet", "Suppress non-error output")
 	.option("--json", "JSON output")
 	.option("--verbose", "Verbose output");
@@ -295,7 +295,7 @@ program.on("command:*", (operands) => {
 	if (suggestion) {
 		process.stderr.write(`Did you mean '${suggestion}'?\n`);
 	}
-	process.stderr.write("Run 'overstory --help' for usage.\n");
+	process.stderr.write("Run 'ov --help' for usage.\n");
 	process.exit(1);
 });
 
@@ -307,20 +307,22 @@ if (import.meta.main)
 	main().catch((err: unknown) => {
 		// Friendly message when running outside a git repository
 		if (err instanceof WorktreeError && err.message.includes("not a git repository")) {
-			process.stderr.write("Not in an overstory project. Run 'overstory init' first.\n");
+			process.stderr.write("Not in an overstory project. Run 'ov init' first.\n");
 			process.exit(1);
 		}
 		if (err instanceof OverstoryError) {
 			process.stderr.write(`Error [${err.code}]: ${err.message}\n`);
-			process.exit(1);
+			process.exitCode = 1;
+			return;
 		}
 		if (err instanceof Error) {
 			process.stderr.write(`Error: ${err.message}\n`);
 			if (process.argv.includes("--verbose")) {
 				process.stderr.write(`${err.stack}\n`);
 			}
-			process.exit(1);
+			process.exitCode = 1;
+			return;
 		}
 		process.stderr.write(`Unknown error: ${String(err)}\n`);
-		process.exit(1);
+		process.exitCode = 1;
 	});

package/src/mail/client.test.ts

@@ -225,7 +225,7 @@ describe("createMailClient", () => {
 			});
 
 			const result = client.checkInject("orchestrator");
-			expect(result).toContain(`overstory mail reply ${id}`);
+			expect(result).toContain(`ov mail reply ${id}`);
 		});
 
 		test("formats multiple messages with correct count", () => {

package/src/mail/client.ts

@@ -96,7 +96,7 @@ function formatForInjection(messages: MailMessage[]): string {
 	}
 
 	const lines: string[] = [
-		`📬 You have ${messages.length} new message${messages.length === 1 ? "" : "s"}:`,
+		`You have ${messages.length} new message${messages.length === 1 ? "" : "s"}:`,
 		"",
 	];
 
@@ -108,7 +108,7 @@ function formatForInjection(messages: MailMessage[]): string {
 		if (msg.payload !== null && PROTOCOL_TYPES.has(msg.type)) {
 			lines.push(`Payload: ${msg.payload}`);
 		}
-		lines.push(`[Reply with: overstory mail reply ${msg.id} --body "..."]`);
+		lines.push(`[Reply with: ov mail reply ${msg.id} --body "..."]`);
 		lines.push("");
 	}
 

package/src/mulch/client.ts

@@ -116,7 +116,7 @@ export function createMulchClient(cwd: string): MulchClient {
 		args: string[],
 		context: string,
 	): Promise<{ stdout: string; stderr: string }> {
-		const { stdout, stderr, exitCode } = await runCommand(["mulch", ...args], cwd);
+		const { stdout, stderr, exitCode } = await runCommand(["ml", ...args], cwd);
 		if (exitCode !== 0) {
 			throw new AgentError(`mulch ${context} failed (exit ${exitCode}): ${stderr.trim()}`);
 		}

package/src/worktree/tmux.test.ts

@@ -210,15 +210,19 @@ describe("createSession", () => {
 		}
 	});
 
-	test("still creates session when which overstory fails (uses fallback)", async () => {
+	test("still creates session when which ov and which overstory both fail (uses fallback)", async () => {
 		let callCount = 0;
 		spawnSpy.mockImplementation(() => {
 			callCount++;
 			if (callCount === 1) {
+				// which ov fails
+				return mockSpawnResult("", "ov not found", 1);
+			}
+			if (callCount === 2) {
 				// which overstory fails
 				return mockSpawnResult("", "overstory not found", 1);
 			}
-			if (callCount === 2) {
+			if (callCount === 3) {
 				// tmux new-session
 				return mockSpawnResult("", "", 0);
 			}
@@ -230,7 +234,8 @@ describe("createSession", () => {
 		expect(pid).toBe(5555);
 
 		// The tmux command should contain the original command
-		const tmuxCallArgs = spawnSpy.mock.calls[1] as unknown[];
+		// Call 0: which ov, Call 1: which overstory, Call 2: tmux new-session
+		const tmuxCallArgs = spawnSpy.mock.calls[2] as unknown[];
 		const cmd = tmuxCallArgs[0] as string[];
 		const tmuxCmd = cmd[7] as string;
 		expect(tmuxCmd).toContain("echo test");

package/src/worktree/tmux.ts

@@ -13,30 +13,31 @@ import { AgentError } from "../errors.ts";
 /**
  * Detect the directory containing the overstory binary.
  *
- * Checks process.argv[0] first (the bun/node executable path won't help,
- * but process.argv[1] is the script path for `bun run`), then falls back
- * to `which overstory` to find it on the current PATH.
+ * Tries `which ov` first (the short alias), then falls back to
+ * `which overstory` (the original name). Both are registered in
+ * package.json bin, but depending on how the tool was installed
+ * (bun link, npm link, global install), only one may be on PATH.
  *
  * Returns null if detection fails.
  */
 async function detectOverstoryBinDir(): Promise<string | null> {
-	// process.argv[1] is the script entry point (e.g., /path/to/overstory/src/index.ts)
-	// The overstory binary (bun link) resolves to a bin dir
-	// Try `which overstory` for the most reliable result
-	try {
-		const proc = Bun.spawn(["which", "overstory"], {
-			stdout: "pipe",
-			stderr: "pipe",
-		});
-		const exitCode = await proc.exited;
-		if (exitCode === 0) {
-			const binPath = (await new Response(proc.stdout).text()).trim();
-			if (binPath.length > 0) {
-				return dirname(resolve(binPath));
+	// Try both command names — the alias migration may leave only one resolvable
+	for (const cmdName of ["ov", "overstory"]) {
+		try {
+			const proc = Bun.spawn(["which", cmdName], {
+				stdout: "pipe",
+				stderr: "pipe",
+			});
+			const exitCode = await proc.exited;
+			if (exitCode === 0) {
+				const binPath = (await new Response(proc.stdout).text()).trim();
+				if (binPath.length > 0) {
+					return dirname(resolve(binPath));
+				}
 			}
+		} catch {
+			// which not available or command not on PATH — try next
 		}
-	} catch {
-		// which not available or overstory not on PATH
 	}
 
 	// Fallback: if process.argv[1] points to overstory's own entry point (src/index.ts),

package/templates/CLAUDE.md.tmpl

@@ -1,6 +1,6 @@
 # {{PROJECT_NAME}} — Overstory Orchestration
 
-> Auto-generated by `overstory init`. You may edit this file.
+> Auto-generated by `ov init`. You may edit this file.
 
 This project uses **overstory** for Claude Code agent orchestration. Your session
 acts as the orchestrator: you decide what work to delegate, spawn worker agents,
@@ -10,34 +10,34 @@ monitor progress, and merge results.
 
 ```bash
 # Spawn a worker agent
-overstory sling <bead-id> --capability <type> --name <agent-name> \
+ov sling <bead-id> --capability <type> --name <agent-name> \
   [--spec <path>] [--files file1,file2] [--parent <agent>] [--depth <n>]
 
 # Check system status
-overstory status              # Overview of all agents, worktrees, {{TRACKER_NAME}}
-overstory status --json       # Machine-readable output
-overstory status --watch      # Live updating
+ov status              # Overview of all agents, worktrees, {{TRACKER_NAME}}
+ov status --json       # Machine-readable output
+ov status --watch      # Live updating
 
 # Messaging (SQLite-backed, ~1-5ms per query)
-overstory mail send --to <agent> --subject "..." --body "..."
-overstory mail check          # Your inbox
-overstory mail list --unread  # All unread messages
-overstory mail reply <id> --body "..."
+ov mail send --to <agent> --subject "..." --body "..."
+ov mail check          # Your inbox
+ov mail list --unread  # All unread messages
+ov mail reply <id> --body "..."
 
 # Merge completed work
-overstory merge --branch <name>   # Merge a specific branch
-overstory merge --all             # Merge all completed branches
-overstory merge --dry-run --branch <name>  # Preview conflicts
+ov merge --branch <name>   # Merge a specific branch
+ov merge --all             # Merge all completed branches
+ov merge --dry-run --branch <name>  # Preview conflicts
 
 # Worktree management
-overstory worktree list       # Show all worktrees with status
-overstory worktree clean --completed  # Remove finished worktrees
+ov worktree list       # Show all worktrees with status
+ov worktree clean --completed  # Remove finished worktrees
 
 # Context and monitoring
-overstory prime               # Reload context (config, mulch, recent activity)
-overstory watch --background  # Start watchdog daemon
-overstory metrics             # Performance summary
-overstory log <event> --agent <name>  # Hook-driven event logging
+ov prime               # Reload context (config, mulch, recent activity)
+ov watch --background  # Start watchdog daemon
+ov metrics             # Performance summary
+ov log <event> --agent <name>  # Hook-driven event logging
 ```
 
 ## How to Spawn Agents
@@ -46,10 +46,10 @@ overstory log <event> --agent <name>  # Hook-driven event logging
 2. Choose a capability based on the task:
 {{AGENT_DEFINITIONS}}
 3. Assign exclusive file scope so agents do not conflict
-4. Spawn: `overstory sling <bead-id> --capability <type> --name <unique-name> --files src/foo.ts,src/bar.ts`
+4. Spawn: `ov sling <bead-id> --capability <type> --name <unique-name> --files src/foo.ts,src/bar.ts`
 
 Each spawned agent gets its own git worktree, branch, CLAUDE.md overlay, and
-tmux session. Agents communicate via `overstory mail` and report completion
+tmux session. Agents communicate via `ov mail` and report completion
 by closing their {{TRACKER_NAME}} issue (`{{TRACKER_CLI}} close <id> --reason "summary"`).
 
 ## Hierarchical Delegation
@@ -58,10 +58,10 @@ You can spawn **team leads** that themselves spawn sub-workers:
 
 ```
 Orchestrator (this session)
-  └── overstory sling bd-xyz --capability lead --name build-lead
-        ├── overstory sling bd-abc --capability builder --name auth-login
-        ├── overstory sling bd-def --capability builder --name auth-signup
-        └── overstory sling bd-ghi --capability builder --name auth-reset
+  └── ov sling bd-xyz --capability lead --name build-lead
+        ├── ov sling bd-abc --capability builder --name auth-login
+        ├── ov sling bd-def --capability builder --name auth-signup
+        └── ov sling bd-ghi --capability builder --name auth-reset
 ```
 
 Depth limit is configurable (default: 2). Leads use `--parent` and `--depth`
@@ -69,7 +69,7 @@ to track hierarchy.
 
 ## Checking Status
 
-Run `overstory status` to see:
+Run `ov status` to see:
 - Active agents and their states (booting, working, stalled, zombie)
 - Worktree locations and branches
 - Beads issue progress
@@ -83,7 +83,7 @@ All merges target **{{CANONICAL_BRANCH}}**. Agents work on branches named
 ## Conventions
 
 - Agents own files exclusively — no two agents modify the same file
-- Use `overstory mail` for all inter-agent communication (not {{TRACKER_NAME}})
+- Use `ov mail` for all inter-agent communication (not {{TRACKER_NAME}})
 - Use `{{TRACKER_CLI}} close` to report task completion (not mail)
-- Merge via `overstory merge`, not raw `git merge`
+- Merge via `ov merge`, not raw `git merge`
 - Logs live in `.overstory/logs/` — never delete them manually

package/templates/hooks.json.tmpl

@@ -6,7 +6,11 @@
 				"hooks": [
 					{
 						"type": "command",
-						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; overstory prime --agent {{AGENT_NAME}}"
+						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; ov prime --agent {{AGENT_NAME}}"
+					},
+					{
+						"type": "command",
+						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; ov mail check --inject --agent {{AGENT_NAME}}"
 					}
 				]
 			}
@@ -17,7 +21,7 @@
 				"hooks": [
 					{
 						"type": "command",
-						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; overstory mail check --inject --agent {{AGENT_NAME}}"
+						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; ov mail check --inject --agent {{AGENT_NAME}}"
 					}
 				]
 			}
@@ -28,7 +32,7 @@
 				"hooks": [
 					{
 						"type": "command",
-						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; overstory log tool-start --agent {{AGENT_NAME}} --stdin"
+						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; ov log tool-start --agent {{AGENT_NAME}} --stdin"
 					}
 				]
 			},
@@ -37,7 +41,7 @@
 				"hooks": [
 					{
 						"type": "command",
-						"command": "read -r INPUT; CMD=$(echo \"$INPUT\" | sed 's/.*\"command\": *\"\\([^\"]*\\)\".*/\\1/'); if echo \"$CMD\" | grep -qE '\\bgit\\s+push\\b'; then echo '{\"decision\":\"block\",\"reason\":\"git push is blocked — use overstory merge to integrate changes, push manually when ready\"}'; exit 0; fi;"
+						"command": "read -r INPUT; CMD=$(echo \"$INPUT\" | sed 's/.*\"command\": *\"\\([^\"]*\\)\".*/\\1/'); if echo \"$CMD\" | grep -qE '\\bgit\\s+push\\b'; then echo '{\"decision\":\"block\",\"reason\":\"git push is blocked — use ov merge to integrate changes, push manually when ready\"}'; exit 0; fi;"
 					}
 				]
 			}
@@ -48,11 +52,11 @@
 				"hooks": [
 					{
 						"type": "command",
-						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; overstory log tool-end --agent {{AGENT_NAME}} --stdin"
+						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; ov log tool-end --agent {{AGENT_NAME}} --stdin"
 					},
 					{
 						"type": "command",
-						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; overstory mail check --inject --agent {{AGENT_NAME}} --debounce 500"
+						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; ov mail check --inject --agent {{AGENT_NAME}} --debounce 500"
 					}
 				]
 			},
@@ -61,7 +65,7 @@
 				"hooks": [
 					{
 						"type": "command",
-						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; overstory mail check --inject --agent {{AGENT_NAME}} --debounce 30000"
+						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; ov mail check --inject --agent {{AGENT_NAME}} --debounce 30000"
 					}
 				]
 			},
@@ -70,7 +74,7 @@
 				"hooks": [
 					{
 						"type": "command",
-						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; read -r INPUT; if echo \"$INPUT\" | grep -qE '\\bgit\\s+commit\\b'; then mulch diff HEAD~1 >/dev/null 2>&1 || true; fi; exit 0;"
+						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; read -r INPUT; if echo \"$INPUT\" | grep -qE '\\bgit\\s+commit\\b'; then ml diff HEAD~1 >/dev/null 2>&1 || true; fi; exit 0;"
 					}
 				]
 			}
@@ -81,11 +85,11 @@
 				"hooks": [
 					{
 						"type": "command",
-						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; overstory log session-end --agent {{AGENT_NAME}} --stdin"
+						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; ov log session-end --agent {{AGENT_NAME}} --stdin"
 					},
 					{
 						"type": "command",
-						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; mulch learn"
+						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; ml learn"
 					}
 				]
 			}
@@ -96,7 +100,7 @@
 				"hooks": [
 					{
 						"type": "command",
-						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; overstory prime --agent {{AGENT_NAME}} --compact"
+						"command": "[ -z \"$OVERSTORY_AGENT_NAME\" ] && exit 0; ov prime --agent {{AGENT_NAME}} --compact"
 					}
 				]
 			}

package/templates/overlay.md.tmpl

@@ -1,5 +1,5 @@
 # DO NOT EDIT — Auto-generated by overstory
-# This overlay was written by `overstory sling`. Manual edits will be
+# This overlay was written by `ov sling`. Manual edits will be
 # overwritten on the next spawn. Modify the template at
 # templates/overlay.md.tmpl in the overstory repo instead.
 
@@ -50,26 +50,26 @@ Prime relevant domain knowledge before starting work:
 
 ## Communication
 
-Use `overstory mail` for all communication. Your address is **{{AGENT_NAME}}**.
+Use `ov mail` for all communication. Your address is **{{AGENT_NAME}}**.
 
 ```bash
 # Check your inbox (do this regularly)
-overstory mail check --agent {{AGENT_NAME}}
+ov mail check --agent {{AGENT_NAME}}
 
 # Send a status update to your parent
-overstory mail send --to {{PARENT_AGENT}} --subject "status" \
+ov mail send --to {{PARENT_AGENT}} --subject "status" \
   --body "Progress update here" --type status --agent {{AGENT_NAME}}
 
 # Ask a question
-overstory mail send --to {{PARENT_AGENT}} --subject "question" \
+ov mail send --to {{PARENT_AGENT}} --subject "question" \
   --body "Your question here" --type question --priority high --agent {{AGENT_NAME}}
 
 # Report completion
-overstory mail send --to {{PARENT_AGENT}} --subject "done" \
+ov mail send --to {{PARENT_AGENT}} --subject "done" \
   --body "Summary of what was done" --type result --agent {{AGENT_NAME}}
 
 # Reply to a message
-overstory mail reply <message-id> --body "Your reply" --agent {{AGENT_NAME}}
+ov mail reply <message-id> --body "Your reply" --agent {{AGENT_NAME}}
 ```
 
 ## Spawning Sub-Workers