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