Index issues

Symptom: the index seems out of date, incomplete, or out of sync with your code.

Start with doctor

bash

$ cix doctor

It reports whether the index is stale (behind your latest commit) and whether any files hit parse errors.

Stale index

If the index is behind, push your latest changes (cix indexes your pushed commit), or force a refresh:

bash

$ cix index

See Keep your index fresh.

Missing symbols or parse errors

If specific files are missing, they may have failed to parse, or be in a language cix does not support yet. cix doctor lists parse errors. Unsupported languages are reported honestly rather than guessed — see Understanding index state.

Still wrong

If the index looks broken even after a refresh, re-link the project with cix init and run cix doctor again. For symptoms that show up as the assistant not finding things, see AI can't find symbols.