Maintenance commands
Day-to-day upkeep: checking index health, catching up after time away, sending a bug report, and removing cix cleanly.
cix vital
A single score for the structural health of your index.
$ cix vital| Flag | What it does |
|---|---|
--json | Machine-readable output |
A low score usually means coverage gaps or parse failures. Index issues covers the fixes.
cix catchup
A structural briefing on what changed since you last looked — what moved shape, not a commit log.
$ cix catchup| Flag | What it does |
|---|---|
--repo PATH | Act on a specific repo root |
--since REF | Start from an explicit commit instead of the detected point |
--mine | Only deltas your branch touches |
--verbose | Include file paths |
--json | Raw output instead of the rendered briefing |
Worth running after a holiday, or before reviewing a branch you've not followed.
cix feedback
Feedback lives on the web now. The command submits nothing itself — it prints the link:
cix feedback
# Send bug reports and feedback at: https://usecix.com/feedbackSign in, describe the problem, and the form returns a ticket id you can quote.
If you pass a message anyway — positionally, with -m, or on stdin — nothing
is sent; the command echoes it back, ready to paste into the form.
cix clean
Delete Claude Code conversation transcripts from your machine. This touches your local assistant history, not your index or your code.
$ cix clean --dry-run| Flag | What it does |
|---|---|
--project NAME | Only sessions under matching project directories |
--older-than DAYS | Only sessions untouched for N days |
--dry-run | Show what would be deleted |
--yes | Skip the confirmation prompt |
--with-memory | Also delete memory directories — off by default |
--dir PATH | Override the projects directory |
Heads — --with-memory wipes the notes your assistant carries between sessions. Deletion is not recoverable, so run --dry-run first.
cix uninstall
Remove cix integrations, and optionally the project files, local state, and the package itself.
$ cix uninstall| Flag | What it does |
|---|---|
--client CLIENTS | Which assistants to remove — defaults to all |
--project | Also remove cix project files for the current repo |
--purge-data | Also remove global cix state, including stored credentials |
--remove-package | Run pip uninstall afterwards |
A full uninstall removes global state automatically; --purge-data is for when you're removing only some clients but still want local state gone.
Turning indexing off for one repo
To stop indexing a repository without uninstalling anything:
$ cix init --disableThis flips the repo off. It makes no other changes and does not delete what was already indexed — re-run cix init to turn it back on.
Next: Troubleshooting.