Troubleshooting

navin not found

navin install-cli

Open a new terminal after a Windows PATH change. On macOS, ~/.local/bin must be on PATH.

Operation not permitted on macOS (~/.local/bin/navin)

A previous install often leaves ~/.local/bin/navin as a symlink into Navin.app (or a signed copy of the engine). Truncating that file in place fails with EPERM.

Retry after removing the old commands:

rm -f ~/.local/bin/navin ~/.local/bin/navin-cli
curl https://navin.live/install -fsS | bash

If that directory is locked, pick another prefix:

NAVIN_PREFIX="$HOME/navin" curl https://navin.live/install -fsS | bash
export PATH="$HOME/navin/bin:$PATH"

WSL: use the Linux one-liner (curl … | bash). The Windows installer does not put navin on the WSL PATH.

/install 404

Use navin.live/download until the site route is live.

Checksum errors

The installer checks SHA256SUMS.txt. Retry a truncated download. Proxies that rewrite HTTPS fail verification.

Doctor

navin doctor

Required misses exit 1. Optional tools only disable those features.

No model

navin status

You need a provider key (Settings or env), a local endpoint, or OAuth. Then an Active model in Settings.

Port busy

navin ports
navin gateway status
navin gateway stop

Slash command does nothing

/help and /status answer immediately. Workflow slashes (/forge, …) need a configured model.

MCP tools missing

Restart after editing MCP config. Names look like mcp_<server>_<tool>.

Logs

navin gateway logs --tail 200
navin cache