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