Add macOS Status Bar Indicator
Installs a macOS menu bar icon that shows NanoClaw's running status with Start, Stop, and Restart controls.
UtilitiesIntermediate★ 30,471⑂ 12,865AI score 6/10Last updated: Aug 9, 2026
What it does
Adds a persistent bolt icon to the macOS menu bar, much like Docker Desktop. A colored dot shows whether NanoClaw is running (green) or stopped (red), and clicking the icon gives you Start / Stop / Restart plus a View Logs shortcut.
The skill walks through three clear phases:
- Pre-flight — confirms you're on macOS, checks for
swiftc(Xcode Command Line Tools), and detects an existing install vialaunchctl - Compile & install — builds the bundled Swift source into
dist/statusbar, clears the quarantine attribute, writes a launchd plist to~/Library/LaunchAgents, and loads it - Verify — checks
launchctl listfor a live PID and explains the indicator to the user
Uninstall steps live in a separate REMOVE.md.
Who it's for
- People who keep NanoClaw running on macOS and want at-a-glance status
- Anyone tired of typing
launchctlorpsjust to check whether the service is up - Developers looking for a reference pattern for controlling a background service from the menu bar
Examples
- First install: run
/add-macos-statusbarfrom the NanoClaw project root to compile the binary and register a login-time launchd agent in one pass. - Restart after a code change: click the menu bar icon and pick Restart instead of switching back to a terminal.
- Troubleshooting: when the dot turns red, use View Logs to open
logs/statusbar.error.logand find the failure.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the .claude/skills/add-macos-statusbar folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/add-macos-statusbar/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw && cp -r /tmp/nanoclaw/.claude/skills/add-macos-statusbar ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Confirm you're on macOS — this skill does not work on Windows or Linux.
- In Terminal, run
which swiftc. If nothing prints, install the Xcode Command Line Tools withxcode-select --install. - Copy the skill into your personal skills folder:
git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw mkdir -p ~/.claude/skills cp -r /tmp/nanoclaw/.claude/skills/add-macos-statusbar ~/.claude/skills/ - Start Claude Code from the root of your NanoClaw project (the binary is built into that project's
dist/). - Type
/add-macos-statusbar, or simply ask for "a macOS menu bar status indicator". - Review and approve the compile and
launchctl loadcommands Claude proposes. - Check that the bolt icon appears in the menu bar and that
launchctl list | grep com.nanoclaw.statusbarreturns a PID. - To remove it later, follow the REMOVE.md instructions in the skill folder.
View source on GitHub ↗License: MIT