macOS Status Bar

How it works

The /add-macos-statusbar skill compiles a small native Swift binary and installs it as a launchd service. The result is a persistent icon in your macOS menu bar that shows whether NanoClaw is running at a glance.

The icon uses a simple color scheme: a green dot means NanoClaw is running, a red dot means it’s stopped. Clicking the icon opens a dropdown menu with Start, Stop, and Restart controls, so you can manage the service without touching the terminal.

Setup

The skill handles everything automatically:

1. Pre-flight — checks that you’re on macOS and that swiftc is available (it comes with Xcode Command Line Tools).
2. Compile — builds the Swift source into a binary at dist/statusbar.
3. Install — creates a launchd plist and loads the service so it starts automatically on login.
4. Verify — confirms the icon appears in the menu bar.

The entire process takes a few seconds. The compiled binary is small and has no runtime dependencies beyond macOS system frameworks.

Tips

• If you don’t see the icon after installation, check System Settings → Login Items to make sure the launchd service is enabled.
• The status indicator polls the NanoClaw process at a short interval. There may be a brief delay between stopping NanoClaw and the icon turning red.
• To uninstall, unload the launchd service and remove the binary from dist/statusbar. The skill doesn’t currently have an uninstall command, but the cleanup is straightforward.
• This skill is macOS-only. On Linux, check the NanoClaw process with standard tools like systemctl or docker ps.