cos: command not found after uv tool install coding-os

Q&A
1

One of the most common install questions — the install succeeds, but a new terminal says zsh: command not found: cos.

Cause: uv installs tool executables into its own bin directory (usually ~/.local/bin), and that directory isn’t always on PATH yet.

Fix:

uv tool update-shell

then open a new terminal (or source ~/.zshrc). Verify with:

cos --version

Prefer to do it manually? Add this to your shell profile:

export PATH="$HOME/.local/bin:$PATH"

pipx install coding-os also works — pipx handles the PATH step during pipx ensurepath. Both installers are covered in the installation docs.