Keep your index fresh
An index is only as useful as it is current. cix keeps yours up to date as you push, so most of the time there is nothing to do. This page is about the cases where a manual nudge helps.
How freshness works
cix tracks the latest commit it has indexed against your repository's current state. When you push changes, the index updates to match. Your assistant's reads resolve against that indexed state.
When to reindex
Force a refresh with cix index when:
cix doctorreports the index is stale.- You just landed a large change — a big refactor, a rename across many files, a new migration — and want the assistant working from it immediately.
- The assistant's answers do not match what you see in your editor. A stale index is the usual cause; see AI can't find symbols.
When not to bother
For ordinary edits, let cix keep up on its own. Reindexing every few minutes is
unnecessary — freshness is checked for you, and cix doctor will tell you when
it actually matters.