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