Getting started

1. Open Noru

Drag Noru to Applications from the DMG, then open the installed copy. Noru is a menu bar app for macOS 13 or newer. The first launch shows a small native status window that explains the hands-free loop while Noru configures detected supported agents in the background. Reopen Noru from Applications to show status again if macOS hides its eye icon behind a crowded menu bar or notch.

The installed app enables Launch at Login so it remains available after a Mac restart. Launching Noru never takes a screenshot by itself; only an accepted agent request or the manual fallback does.

2. Allow Screen Recording and agent observations

Choose Allow Screen Recording... and approve Noru in System Settings. First-run authorization also asks you to allow connected agents to request observations; Screen Recording alone does not imply that delegation. You can pause perception or revoke it later from the menu. Noru does not need Accessibility or Input Monitoring for this observe-only workflow.

3. Reload your coding agent once

Noru automatically registers itself with detected supported agents, including Codex and the ChatGPT desktop app. Restart or reload an agent that was already open so it reads the updated MCP configuration. Use Check & Repair Agent Connection... only when the status window reports a problem. Cursor and VS Code also need the documentedone-time global routing rule for reliable automatic calls.

4. Ask normally

Put the content you want help with on the Mac and refer to it: “what is this error?” or “fix what is wrong here.” For native or cross-app context, the agent decides whether to call get_latest_capture. Noru observes the main display once, shows Capture ready (“Your main display is ready for your agent.”), then returns that image and OCR so the agent can answer. History reads (list_captures /get_capture) never take a new screenshot.