Browse docs

← All docs

docs / ai-cant-find-symbols.md

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

  1. Is the client connected? If the assistant never seems to use cix, the client may not be registered. Re-run cix install and restart the client.
  2. Is the index fresh? Run cix doctor. If it reports the index is stale, push your changes or run cix index. A symbol you just added won't be found until it is indexed.
  3. Is the right project linked? From the repo, run cix init so queries resolve to this project and not another.
  4. Did the file parse? cix doctor lists 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.