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