Navi 🧚

Navi 🧚

Hey! Listen!

A desktop notifier for AI agents, styled after the fairy from The Legend ofZelda: Ocarina of Time. Navi floats on your screen; when an agent (ClaudeCode or any MCP client) calls her notify tool, she rings, changes color,and shows the message in a speech bubble — so you know when an agent needsyou without watching the terminal.

Idle, she glows soft blue, bobs, flaps her wings, sheds sparks, and driftslazily around her corner of the screen. Drag her anywhere by her body.

How it works

One Electron app hosts both:

• An MCP server (streamable HTTP, stateless) on 0.0.0.0:8641, exposinga single tool:

  notify(kind: "urgent" | "warning" | "success", message: string, title?: string)
  

• The fairy overlay — a transparent, frameless, always-on-top window.

A tray icon provides per-kind test notifications, a "Copy MCP add command"shortcut, and Quit.

Requirements

• Windows 10/11 with Node.js LTS (the app is Windows-only: transparentoverlay + audio).
• Agents can run anywhere that can reach port 8641 — including WSL2.

Run from source

npm install
npm start

Allow the Windows Firewall prompt on first launch (tick Public if youragents connect from WSL2 — the WSL virtual adapter is usually classifiedPublic).

Build the exe

npm run package

Output: release/navi-win32-x64/navi.exe. Launching it starts the MCPserver automatically; on startup Navi's speech bubble shows the exactcommand to register her with Claude Code.

Connect an agent

From Windows:

claude mcp add --transport http navi http://localhost:8641/mcp

From WSL2 (NAT mode — the default), use the Windows host IP instead:

HOST=$(ip route show default | awk '{print $3}')
claude mcp add --transport http navi http://$HOST:8641/mcp

The NAT IP can change after a reboot — re-run the command if calls stopconnecting, or enable networkingMode=mirrored in .wslconfig solocalhost works from WSL too. The tray's Copy MCP add command alwayshas the current URL.

Then just ask your agent to use it, or add a standing instruction like:

When you finish a task, need my approval, or hit a problem, call thenotify tool (kind: success / urgent / warning).

The chime

Drop your own sound at assets/hey_listen.mp3 (gitignored — bring your own;Nintendo's audio cannot be distributed with this repo). Without the file,Navi synthesizes a two-note fairy chime with WebAudio.

Development notes

• No bundler: two tsc projects (tsconfig.json for main/preload,tsconfig.renderer.json for browser-global renderer scripts).
• npm run build compiles both; see CLAUDE.md for the full developmentlog and environment gotchas.

Known limitations

• The server listens on 0.0.0.0, so any LAN host can triggernotifications. Fine for a home setup; firewall the port if that bothersyou.
• Always-on-top does not cover exclusive-fullscreen games.