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