AI can't find symbols
Symptom: your assistant says it can't find a function, file, or table that you know exists — or it answers as if recent changes aren't there.
This is almost always an index that is behind your code, or a client that isn't actually talking to cix.
Check, in order
- Is the client connected? If the assistant never seems to use cix, the
client may not be registered. Re-run
cix installand restart the client. - Is the index fresh? Run
cix doctor. If it reports the index is stale, push your changes or runcix index. A symbol you just added won't be found until it is indexed. - Is the right project linked? From the repo, run
cix initso queries resolve to this project and not another. - Did the file parse?
cix doctorlists parse errors; a file that failed to parse contributes no symbols. Unsupported languages are reported rather than guessed — see Understanding index state.
Still missing
Ask the assistant to search explicitly ("search the index for Name") so you
can see whether the miss is the index or the client. If the symbol is genuinely
absent from a fresh, clean index, it may be in an unsupported language or a file
cix could not parse.