/new-command

name: new-command
description: Scaffold a new CLI command for Cortex TMS following the existing codebase patterns.
disable-model-invocation: true

New Command

Scaffold a new CLI command for Cortex TMS.

Before Writing Code

1. **Read existing patterns** — look at src/commands/archive.ts and src/commands/status.ts as reference implementations 2. **Read types** — check src/types/cli.ts for existing interfaces 3. **Read tests** — check src/__tests__/archive.test.ts for the test pattern 4. **Propose the command** — describe what it does, its subcommands/options, and which files will be created/modified. Follow Propose/Justify/Recommend. Wait for approval.

Implementation Checklist

After the user approves the plan:

• [ ] Create `src/commands/<name>.ts` — export `createXCommand()` and `xCommand`
• [ ] Add types to `src/types/cli.ts` if needed
• [ ] Register in `src/cli.ts` — import and `program.addCommand()`
• [ ] Create `src/__tests__/<name>.test.ts` — follow existing test patterns
• [ ] Add section to `README.md` under CLI Commands
• [ ] Update `NEXT-TASKS.md` — check off the task

Rules

• Match the exact patterns in existing commands (Commander.js, chalk, ora)
• Follow existing test patterns (vitest, createTempDir, runCommand)
• If the user asks a question, STOP and answer before continuing
• Show git diff before committing. Wait for approval.

Arguments

$ARGUMENTS — the name and purpose of the new command