Common setup problems

A grab bag of the issues people hit during first setup. When in doubt, run cix doctor — it names most of these directly.

`cix: command not found`

The package installed but its scripts aren't on your PATH, or it went into a different Python environment. Confirm the install:

bash

$ pip show usecix

Reinstall into the interpreter you actually use (python3.11 -m pip install usecix), and make sure that Python's scripts directory is on your PATH.

cix needs Python 3.11+. Check with python --version. If your default is older, install under a newer one with an explicit interpreter.

The client wasn't registered, or wasn't restarted. Run cix install and restart the client.

A permission or repository change is waiting on owner approval. See GitHub not connected.

Access granted but not enabled, not linked, or over your plan's repo limit. See Repository not enabled.

The index is behind your code. See Index issues and Keep your index fresh.

If none of these match, cix doctor will point at the specific failing check and the action to take.