fix(cli): expose zoo command

Author: taltas

.github/workflows/cli-release.yml

@@ -148,9 +148,9 @@ jobs:
             '' \
             '// Import and run the actual CLI' \
             "await import(join(__dirname, '..', 'lib', 'index.js'));" \
-            > "$RELEASE_DIR/bin/roo"
+            > "$RELEASE_DIR/bin/zoo"
 
-          chmod +x "$RELEASE_DIR/bin/roo"
+          chmod +x "$RELEASE_DIR/bin/zoo"
 
           # Create empty .env file.
           touch "$RELEASE_DIR/.env"
@@ -189,7 +189,8 @@ jobs:
           ls -la "$VERIFY_DIR/roo-cli-${PLATFORM}/"
 
           # Check required files exist.
-          test -f "$VERIFY_DIR/roo-cli-${PLATFORM}/bin/roo" || { echo "Missing bin/roo"; exit 1; }
+          test -f "$VERIFY_DIR/roo-cli-${PLATFORM}/bin/zoo" || { echo "Missing bin/zoo"; exit 1; }
+          test ! -e "$VERIFY_DIR/roo-cli-${PLATFORM}/bin/roo" || { echo "Unexpected legacy bin/roo"; exit 1; }
           test -f "$VERIFY_DIR/roo-cli-${PLATFORM}/lib/index.js" || { echo "Missing lib/index.js"; exit 1; }
           test -f "$VERIFY_DIR/roo-cli-${PLATFORM}/package.json" || { echo "Missing package.json"; exit 1; }
           test -d "$VERIFY_DIR/roo-cli-${PLATFORM}/extension" || { echo "Missing extension directory"; exit 1; }
@@ -342,10 +343,10 @@ jobs:
           echo "" >> "$NOTES_FILE"
           echo '```bash' >> "$NOTES_FILE"
           echo "# Run a task" >> "$NOTES_FILE"
-          echo 'roo "What is this project?"' >> "$NOTES_FILE"
+          echo 'zoo "What is this project?"' >> "$NOTES_FILE"
           echo "" >> "$NOTES_FILE"
           echo "# See all options" >> "$NOTES_FILE"
-          echo "roo --help" >> "$NOTES_FILE"
+          echo "zoo --help" >> "$NOTES_FILE"
           echo '```' >> "$NOTES_FILE"
           echo "" >> "$NOTES_FILE"
           echo "## Platform Support" >> "$NOTES_FILE"

apps/cli/README.md

@@ -44,13 +44,13 @@ curl -fsSL https://raw.githubusercontent.com/RooCodeInc/Roo-Code/main/apps/cli/i
 Or run:
 
 ```bash
-roo upgrade
+zoo upgrade
 ```
 
 ### Uninstalling
 
 ```bash
-rm -rf ~/.roo/cli ~/.local/bin/roo
+rm -rf ~/.roo/cli ~/.local/bin/zoo
 ```
 
 ### Development Installation
@@ -77,13 +77,13 @@ By default, the CLI auto-approves actions and runs in interactive TUI mode:
 ```bash
 export OPENROUTER_API_KEY=sk-or-v1-...
 
-roo "What is this project?" -w ~/Documents/my-project
+zoo "What is this project?" -w ~/Documents/my-project
 ```
 
 You can also run without a prompt and enter it interactively in TUI mode:
 
 ```bash
-roo -w ~/Documents/my-project
+zoo -w ~/Documents/my-project
 ```
 
 In interactive mode:
@@ -98,7 +98,7 @@ In interactive mode:
 If you want manual approval prompts, enable approval-required mode:
 
 ```bash
-roo "Refactor the utils.ts file" --require-approval -w ~/Documents/my-project
+zoo "Refactor the utils.ts file" --require-approval -w ~/Documents/my-project
 ```
 
 In approval-required mode:
@@ -112,10 +112,10 @@ Use `--print` for non-interactive execution and machine-readable output:
 
 ```bash
 # Prompt is required
-roo --print "Summarize this repository"
+zoo --print "Summarize this repository"
 
 # Create a new task with a specific session ID (UUID)
-roo --print --create-with-session-id 018f7fc8-7c96-7f7c-98aa-2ec4ff7f6d87 "Summarize this repository"
+zoo --print --create-with-session-id 018f7fc8-7c96-7f7c-98aa-2ec4ff7f6d87 "Summarize this repository"
 ```
 
 ### Autonomous Orchestrator Draft (`--autonomous`)
@@ -127,7 +127,7 @@ Every new autonomous root starts in the effective `orchestrator` mode. A project
 ```bash
 export OPENROUTER_API_KEY=sk-or-v1-...
 
-roo --autonomous --print \
+zoo --autonomous --print \
   --workspace /absolute/path/to/project \
   --timeout 3600 \
   --output-format stream-json \
@@ -186,10 +186,10 @@ For programmatic control (one process, multiple prompts), use `--stdin-prompt-st
 Send NDJSON commands via stdin:
 
 ```bash
-printf '{"command":"start","requestId":"1","prompt":"1+1=?"}\n' | roo --print --stdin-prompt-stream --output-format stream-json
+printf '{"command":"start","requestId":"1","prompt":"1+1=?"}\n' | zoo --print --stdin-prompt-stream --output-format stream-json
 
 # Optional: provide taskId per start command
-printf '{"command":"start","requestId":"1","taskId":"018f7fc8-7c96-7f7c-98aa-2ec4ff7f6d87","prompt":"1+1=?"}\n' | roo --print --stdin-prompt-stream --output-format stream-json
+printf '{"command":"start","requestId":"1","taskId":"018f7fc8-7c96-7f7c-98aa-2ec4ff7f6d87","prompt":"1+1=?"}\n' | zoo --print --stdin-prompt-stream --output-format stream-json
 ```
 
 ### Legacy Roo Auth Token Cleanup
@@ -200,10 +200,10 @@ Roo Code Router has been removed from the CLI. The remaining `auth` commands onl
 
 ```bash
 # Check whether a legacy Roo auth token is still stored
-roo auth status
+zoo auth status
 
 # Remove an old stored Roo auth token
-roo auth logout
+zoo auth logout
 ```
 
 If you never used Roo Code Router, you can ignore this section entirely.
@@ -239,8 +239,8 @@ If you never used Roo Code Router, you can ignore this section entirely.
 
 | Command           | Description                          |
 | ----------------- | ------------------------------------ |
-| `roo auth logout` | Clear a stored legacy Roo auth token |
-| `roo auth status` | Show legacy Roo token status         |
+| `zoo auth logout` | Clear a stored legacy Roo auth token |
+| `zoo auth status` | Show legacy Roo token status         |
 
 ## Environment Variables
 

apps/cli/docs/AGENT_LOOP.md

@@ -321,7 +321,7 @@ if (isInteractiveAsk(ask)) {
 Enable with `-d` flag. Logs go to `~/.roo/cli-debug.log`:
 
 ```bash
-roo -d -P "Build something" --no-tui
+zoo -d -P "Build something" --no-tui
 ```
 
 View logs:

apps/cli/install.sh

@@ -54,7 +54,7 @@ Install Node.js:
 
 Please upgrade Node.js to version $MIN_NODE_VERSION or higher."
     fi
-    
+
     info "Found Node.js $(node -v)"
 }
 
@@ -242,7 +242,7 @@ Available at: https://github.com/$REPO/releases"
     fi
 
     # Make executable
-    chmod +x "$INSTALL_DIR/bin/roo"
+    chmod +x "$INSTALL_DIR/bin/zoo"
 
     # Also make ripgrep executable if it exists
     if [ -f "$INSTALL_DIR/bin/rg" ]; then
@@ -253,14 +253,19 @@ Available at: https://github.com/$REPO/releases"
 # Create symlink in bin directory
 setup_bin() {
     mkdir -p "$BIN_DIR"
-    
-    # Remove old symlink if exists
+
+    # Remove the executable name used by earlier CLI releases.
     if [ -L "$BIN_DIR/roo" ] || [ -f "$BIN_DIR/roo" ]; then
         rm -f "$BIN_DIR/roo"
     fi
-    
-    ln -sf "$INSTALL_DIR/bin/roo" "$BIN_DIR/roo"
-    info "Created symlink: $BIN_DIR/roo"
+
+    # Remove old symlink if exists
+    if [ -L "$BIN_DIR/zoo" ] || [ -f "$BIN_DIR/zoo" ]; then
+        rm -f "$BIN_DIR/zoo"
+    fi
+
+    ln -sf "$INSTALL_DIR/bin/zoo" "$BIN_DIR/zoo"
+    info "Created symlink: $BIN_DIR/zoo"
 }
 
 # Check if bin dir is in PATH and provide instructions
@@ -305,10 +310,10 @@ check_path() {
 
 # Verify installation
 verify_install() {
-    if [ -x "$BIN_DIR/roo" ]; then
+    if [ -x "$BIN_DIR/zoo" ]; then
         info "Verifying installation..."
         # Just check if it runs without error
-        "$BIN_DIR/roo" --version >/dev/null 2>&1 || true
+        "$BIN_DIR/zoo" --version >/dev/null 2>&1 || true
     fi
 }
 
@@ -318,15 +323,15 @@ print_success() {
     printf "${GREEN}${BOLD}✓ Roo Code CLI installed successfully!${NC}\n"
     echo ""
     echo "  Installation: $INSTALL_DIR"
-    echo "  Binary: $BIN_DIR/roo"
+    echo "  Binary: $BIN_DIR/zoo"
     echo "  Version: $VERSION"
     echo ""
     echo "  ${BOLD}Get started:${NC}"
-    echo "    roo --help"
+    echo "    zoo --help"
     echo ""
     echo "  ${BOLD}Example:${NC}"
     echo "    export OPENROUTER_API_KEY=sk-or-v1-..."
-    echo "    cd ~/my-project && roo \"What is this project?\""
+    echo "    cd ~/my-project && zoo \"What is this project?\""
     echo ""
 }
 

apps/cli/package.json

@@ -6,7 +6,7 @@
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {
-		"roo": "dist/index.js"
+		"zoo": "dist/index.js"
 	},
 	"scripts": {
 		"format": "prettier --write 'src/**/*.ts'",

apps/cli/scripts/build.sh

@@ -188,7 +188,7 @@ create_tarball() {
 
     # Create the wrapper script
     info "Creating wrapper script..."
-    cat > "$RELEASE_DIR/bin/roo" << 'WRAPPER_EOF'
+    cat > "$RELEASE_DIR/bin/zoo" << 'WRAPPER_EOF'
 #!/usr/bin/env node
 
 import { fileURLToPath } from 'url';
@@ -210,7 +210,7 @@ if (existsSync(ripgrepPath)) {
 await import(join(__dirname, '..', 'lib', 'index.js'));
 WRAPPER_EOF
 
-    chmod +x "$RELEASE_DIR/bin/roo"
+    chmod +x "$RELEASE_DIR/bin/zoo"
 
     # Create empty .env file
     touch "$RELEASE_DIR/.env"
@@ -267,15 +267,21 @@ verify_local_install() {
         error "Installation verification failed!"
     }
 
+    # Ensure only the public executable is installed.
+    if [ -e "$VERIFY_BIN_DIR/roo" ]; then
+        rm -rf "$VERIFY_DIR"
+        error "Legacy roo executable was installed!"
+    fi
+
     # Test --help
-    if ! "$VERIFY_BIN_DIR/roo" --help > /dev/null 2>&1; then
+    if ! "$VERIFY_BIN_DIR/zoo" --help > /dev/null 2>&1; then
         rm -rf "$VERIFY_DIR"
         error "CLI --help check failed!"
     fi
     info "CLI --help check passed"
 
     # Test --version
-    if ! "$VERIFY_BIN_DIR/roo" --version > /dev/null 2>&1; then
+    if ! "$VERIFY_BIN_DIR/zoo" --version > /dev/null 2>&1; then
         rm -rf "$VERIFY_DIR"
         error "CLI --version check failed!"
     fi
@@ -317,11 +323,11 @@ print_summary() {
 
     if [ "$LOCAL_INSTALL" = true ]; then
         echo "  Installed to: ~/.roo/cli"
-        echo "  Binary: ~/.local/bin/roo"
+        echo "  Binary: ~/.local/bin/zoo"
         echo ""
         echo "  Test it out:"
-        echo "    roo --version"
-        echo "    roo --help"
+        echo "    zoo --version"
+        echo "    zoo --help"
     else
         echo "  To install manually:"
         echo "    ROO_LOCAL_TARBALL=$REPO_ROOT/$TARBALL ./apps/cli/install.sh"

apps/cli/src/__tests__/package.test.ts

@@ -0,0 +1,13 @@
+import fs from "node:fs"
+import path from "node:path"
+import { fileURLToPath } from "node:url"
+
+describe("CLI package", () => {
+	it("publishes only the zoo executable", () => {
+		const packagePath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../package.json")
+		const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf8")) as { bin?: Record<string, string> }
+
+		expect(packageJson.bin).toEqual({ zoo: "dist/index.js" })
+		expect(packageJson.bin).not.toHaveProperty("roo")
+	})
+})

apps/cli/src/commands/auth/status.ts

@@ -49,7 +49,7 @@ export async function status(options: StatusOptions = {}): Promise<StatusResult>
 	}
 
 	if (expiringSoon) {
-		console.log("⚠ Legacy Roo auth token expires soon; use `roo auth logout` if you want to clean it up.")
+		console.log("⚠ Legacy Roo auth token expires soon; use `zoo auth logout` if you want to clean it up.")
 	} else {
 		console.log("✓ Legacy Roo auth token still stored")
 	}

apps/cli/src/commands/cli/run.ts

@@ -133,7 +133,7 @@ export async function run(promptArg: string | undefined, flagOptions: FlagOption
 
 	if (isResumeRequested && prompt) {
 		console.error("[CLI] Error: cannot use prompt or --prompt-file with --session-id/--continue")
-		console.error("[CLI] Usage: roo [--session-id <session-id> | --continue] [options]")
+		console.error("[CLI] Usage: zoo [--session-id <session-id> | --continue] [options]")
 		exitValidation("cannot use prompt or --prompt-file with --session-id/--continue")
 	}
 
@@ -287,39 +287,39 @@ export async function run(promptArg: string | undefined, flagOptions: FlagOption
 	// Output format only works with --print mode
 	if (outputFormat !== "text" && !flagOptions.print && isTuiSupported) {
 		console.error("[CLI] Error: --output-format requires --print mode")
-		console.error("[CLI] Usage: roo --print --output-format json")
+		console.error("[CLI] Usage: zoo --print --output-format json")
 		exitValidation("--output-format requires --print mode")
 	}
 
 	if (flagOptions.stdinPromptStream && !flagOptions.print) {
 		console.error("[CLI] Error: --stdin-prompt-stream requires --print mode")
-		console.error("[CLI] Usage: roo --print --output-format stream-json --stdin-prompt-stream [options]")
+		console.error("[CLI] Usage: zoo --print --output-format stream-json --stdin-prompt-stream [options]")
 		exitValidation("--stdin-prompt-stream requires --print mode")
 	}
 
 	if (flagOptions.signalOnlyExit && !flagOptions.stdinPromptStream) {
 		console.error("[CLI] Error: --signal-only-exit requires --stdin-prompt-stream")
-		console.error("[CLI] Usage: roo --print --output-format stream-json --stdin-prompt-stream --signal-only-exit")
+		console.error("[CLI] Usage: zoo --print --output-format stream-json --stdin-prompt-stream --signal-only-exit")
 		exitValidation("--signal-only-exit requires --stdin-prompt-stream")
 	}
 
 	if (flagOptions.stdinPromptStream && outputFormat !== "stream-json") {
 		console.error("[CLI] Error: --stdin-prompt-stream requires --output-format=stream-json")
-		console.error("[CLI] Usage: roo --print --output-format stream-json --stdin-prompt-stream [options]")
+		console.error("[CLI] Usage: zoo --print --output-format stream-json --stdin-prompt-stream [options]")
 		exitValidation("--stdin-prompt-stream requires --output-format=stream-json")
 	}
 
 	if (flagOptions.stdinPromptStream && process.stdin.isTTY) {
 		console.error("[CLI] Error: --stdin-prompt-stream requires piped stdin")
 		console.error(
-			'[CLI] Example: printf \'{"command":"start","requestId":"1","prompt":"1+1=?"}\\n\' | roo --print --output-format stream-json --stdin-prompt-stream [options]',
+			'[CLI] Example: printf \'{"command":"start","requestId":"1","prompt":"1+1=?"}\\n\' | zoo --print --output-format stream-json --stdin-prompt-stream [options]',
 		)
 		exitValidation("--stdin-prompt-stream requires piped stdin")
 	}
 
 	if (flagOptions.stdinPromptStream && prompt) {
 		console.error("[CLI] Error: cannot use positional prompt or --prompt-file with --stdin-prompt-stream")
-		console.error("[CLI] Usage: roo --print --output-format stream-json --stdin-prompt-stream [options]")
+		console.error("[CLI] Usage: zoo --print --output-format stream-json --stdin-prompt-stream [options]")
 		exitValidation("cannot use a prompt with --stdin-prompt-stream")
 	}
 
@@ -347,13 +347,13 @@ export async function run(promptArg: string | undefined, flagOptions: FlagOption
 		if (!prompt && !useStdinPromptStream && !isResumeRequested) {
 			if (flagOptions.print) {
 				console.error("[CLI] Error: no prompt provided")
-				console.error("[CLI] Usage: roo --print [options] <prompt>")
+				console.error("[CLI] Usage: zoo --print [options] <prompt>")
 				console.error(
-					"[CLI] For stdin control mode: roo --print --output-format stream-json --stdin-prompt-stream [options]",
+					"[CLI] For stdin control mode: zoo --print --output-format stream-json --stdin-prompt-stream [options]",
 				)
 			} else {
 				console.error("[CLI] Error: prompt is required in non-interactive mode")
-				console.error("[CLI] Usage: roo <prompt> [options]")
+				console.error("[CLI] Usage: zoo <prompt> [options]")
 				console.error("[CLI] Run without -p for interactive mode")
 			}
 

apps/cli/src/index.ts

@@ -6,7 +6,7 @@ import { run, logout, status, listCommands, listModes, listModels, listSessions,
 const program = new Command()
 
 program
-	.name("roo")
+	.name("zoo")
 	.description("Roo Code CLI - starts an interactive session by default, use -p/--print for non-interactive output")
 	.version(VERSION)
 	.enablePositionalOptions()