# Troubleshooting

## Troubleshooting

- **Nib is not running:** the installed shim should launch it automatically. Open `/Applications/Nib.app` manually if macOS blocks the first launch.
- **No `nib` tools:** restart the agent after applying MCP configuration.
- **Old path in the config:** rerun **Nib → Set up agents…**. Installed paths must begin with `/Applications/Nib.app`; they must never reference `node_modules`.
- **Invalid batch:** read the returned operation index, JSON path, and validation message; correct the whole batch and retry.
- **Wrong visual output:** call `screenshot`, then `snapshot_layout`; do not infer rendering quality from the document tree alone.