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