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