If Something Goes Wrong
Last updated
Fixes for the problems beginners hit most often during the quickstart.
| Symptom | Fix |
|---|---|
agen: command not found | /usr/local/bin is not on your PATH. Open a new shell, or add it |
| The model list is empty after approving Copilot | The authorization did not finish or expired after 15 minutes. Re-run /model → add → GitHub Copilot and approve the new code |
| Every tool call stops and asks for confirmation | The TUI is in safe (⏸ safe): it starts there when the working directory is $HOME, outside $HOME, or a denied or sensitive path. Shift+Tab switches to auto (⏵⏵ auto), which only takes effect inside a subdirectory of $HOME; set one with Shift+P |
| The agent answers but never calls a tool | Small open-weight models drop tool calls. Register a larger model — a subscription provider (codex, grok-oauth, copilot) needs no per-token billing |
| A command fails with a permission error | Commands run inside an OS sandbox. See Sandbox for what it blocks and how to allow more |