Scan and repair Zoo Code / Roo-code task history indexes and corrupted task metadata.
Zoo Code stores task history as JSON files under
~/.zoo-code/globalStorage/wecode-ai.zoo-code/tasks/. Each task directory
contains history_item.json, api_conversation_history.json, ui_messages.json,
task_metadata.json, plus a global _index.json. This tool detects and repairs
common corruption patterns across those files.
Full behavior — commands, repair algorithms, backup/restore model, detection
model, file I/O, validation, and architecture — is specified in
SPECIFICATION.md.
npm install -g zoo-code-history-repairNo install required for one-off use: prefix commands with npx:
npx zoo-code-history-repair scan# Scan for corruption
zoo-code-history-repair scan
zoo-code-history-repair scan --short # List corrupted task IDs only
zoo-code-history-repair scan --quiet # summary only
zoo-code-history-repair scan --json # machine-parseable JSON
# Rebuild the global index / a single task / all corrupted tasks (dry-run by default)
zoo-code-history-repair repair --index [--force]
zoo-code-history-repair repair <taskId> [--force]
zoo-code-history-repair repair --all [--force]
# Delete a task directory + its _index entry
zoo-code-history-repair delete <taskId> [--force] # actually delete
# Manage backup files
zoo-code-history-repair restore # list all backups
zoo-code-history-repair restore <taskId> [--force] # restore newest backup
zoo-code-history-repair restore --delete <taskId> [--force] # delete backupsAll write commands default to dry-run; pass --force to apply changes.
Dry-run messages are colorized red. Disable colors with --no-color or
NO_COLOR=1. help <command> shows detailed per-command help.
| Command | One-liner |
|---|---|
scan |
Cross-reference _index.json vs task dirs and report corruption |
scan --short |
List only corrupted task IDs with recoverability % |
validate [file|uuid] |
Validate task storage files against schema rules |
repair --index |
Rebuild _index.json from each task's history_item.json |
repair <taskId> |
Repair ui/task/size/tokens/refs/interrupted for one task |
repair --all |
Repair all corrupted tasks, then rebuild _index.json |
restore [taskId] [ts] |
List, restore, or delete backup files |
delete <taskId> |
Delete a task directory + its _index entry |
See SPECIFICATION.md for the full consolidated
specification.
MIT