zsh: killed nerd right after installing from source | The binary was copied over the old one. Reinstall with install and codesign as in Build from source. |
⌥ keys type characters instead of acting | Press ⌃+B, then the key, which works in any terminal; or nerd --preset <terminal> sets the terminal to send Option as Alt. See Keys. |
| A supported agent shows no state, or the wrong one | Install the hook: Settings… → Agent hooks, or nerd --install-hook. |
| A hooked Codex shows no state | Codex runs no new hook until you approve it: at its "Hooks need review" prompt, choose "Trust all and continue". |
nerd send says cannot reach nerd | The agent's own sandbox blocks the socket; see Messages. |
| Images in the preview look blocky | The terminal has no Kitty graphics protocol, or nerd runs inside tmux. Run nerd directly in Ghostty, Kitty, WezTerm or iTerm2, or set images to off. |
| Colours look more saturated than in other terminals | WezTerm and iTerm2 show colours in Display P3; nerd's colours are sRGB. |
| An image in the preview looks broken | Set images to blocks. |