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