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.