cix doctor

Diagnoses your cix install and project setup, and tells you what to fix. This is the command to run whenever something is not working.

bash

$ cix doctor

Run it from inside a repository to check that project too.

Flags

Flag	What it does
`--json`	Emit the same report as JSON, for scripting
`--repair-duplicates`	Fix a machine where two `cix`/`usecix` distributions share one environment. Report-only until you add `--yes`
`--yes`	Confirm the package changes `--repair-duplicates` makes

cix doctor runs a series of checks and reports each as pass or fail, with a suggested next action. It covers, among other things:

whether you are logged in and your install is wired correctly;
whether your AI clients (Claude Code, Codex, Gemini CLI, Cursor) are registered;
the project's link and whether it has been indexed;
parse errors and whether the index is stale relative to your latest commit;
duplicate installations — two cix/usecix distributions sharing one environment. Doctor prints the repair recipe, and --repair-duplicates --yes runs it for you.

If every check passes, your setup is healthy. If one fails, doctor prints the specific action to take.

bash

$ cix doctor --json

Emits the same report as JSON.