Agent skill

macOS Menu Bar Status for NanoClaw

by nanocoai in nanocoai/nanoclaw

Adds a macOS menu bar icon that shows whether NanoClaw is running and offers Start, Stop, Restart and View Logs controls.

MITAuto-check passedProductivity & Automation

Install macOS Menu Bar Status for NanoClaw

skills CLI
$ npx skills add nanocoai/nanoclaw --skill add-macos-statusbar -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nanocoai/nanoclaw add-macos-statusbar --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nanocoai/nanoclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/add-macos-statusbar .claude/skills/add-macos-statusbar && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
add-macos-statusbar
GitHub stars
31k
Token cost
~780 tokens
SKILL.md length
256 words
Files
3
Skills in repo
59
Repo updated
First seen
Licence
MIT

At a glance

Adds a macOS menu bar icon that shows whether NanoClaw is running and offers Start, Stop, Restart and View Logs controls.

  • Works in 3 steps: Pre-flight → Compile and Install → Verify
  • Seeing at a glance whether NanoClaw is running on your Mac
  • SKILL.md covers Phase 1: Pre-flight, Phase 2: Compile and Install and Phase 3: Verify
  • Runs Swift scripts from its folder; reaches apple.com

What it does

A small Swift program adds a menu bar icon, a bolt with a green dot when NanoClaw is running and a red dot when it is stopped, plus Start, Stop, Restart and View Logs controls, much like Docker Desktop's menu bar entry. It is macOS only, since it uses AppKit and needs `swiftc` from the Xcode Command Line Tools.

The skill first checks the platform, the compiler and whether the `com.nanoclaw.statusbar` agent already runs. It then compiles `statusbar.swift` into `dist/statusbar`, clears the quarantine attribute on macOS Sequoia or later, writes a launchd plist in `~/Library/LaunchAgents` and loads it with `launchctl`. A final check expects a process ID in the `launchctl list` output. Removal steps are in `REMOVE.md`.

When your agent uses it

  • Seeing at a glance whether NanoClaw is running on your Mac
  • Restarting NanoClaw from the menu bar after code changes
  • Opening the NanoClaw log file without using a terminal

Example prompts

  • “Add the NanoClaw status icon to my Mac's menu bar.”
  • “The status bar helper will not launch after an upgrade. Check the launchd service.”
  • “Install Xcode Command Line Tools if needed, then build and load the menu bar indicator.”

Requirements

  • macOS
  • Xcode Command Line Tools with `swiftc`
  • A NanoClaw installation

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Pre-flight
  2. Compile and Install
  3. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit a0c79dd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Swift), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • apple.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

macOS Menu Bar Status for NanoClaw loads about 780 tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 256 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~780

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nanocoai/nanoclaw at commit a0c79dd, republished under its MIT licence (© nanocoai). 256 words, ~780 tokens.

Download SKILL.mdSave it as .claude/skills/add-macos-statusbar/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
add-macos-statusbar
description
Add a macOS menu bar status indicator for NanoClaw. Shows a bolt icon with a green/red dot indicating whether NanoClaw is running, with Start, Stop, and Restart controls. macOS only.

Add macOS Menu Bar Status Indicator

Adds a persistent menu bar icon that shows NanoClaw's running status and lets the user start, stop, or restart the service — similar to how Docker Desktop appears in the menu bar.

macOS only. Requires Xcode Command Line Tools (swiftc).

Phase 1: Pre-flight

Check platform

If not on macOS, stop and tell the user:

This skill is macOS only. The menu bar status indicator uses AppKit and requires swiftc (Xcode Command Line Tools).

Check for swiftc
bash
which swiftc

If not found, tell the user:

Xcode Command Line Tools are required. Install them by running:

bash
xcode-select --install

Then re-run /add-macos-statusbar.

Check if already installed
bash
launchctl list | grep com.nanoclaw.statusbar

If it returns a PID (not -), tell the user it's already installed and skip to Phase 3 (Verify).

Phase 2: Compile and Install

Compile the Swift binary

The source lives in the skill directory. Compile it into dist/:

bash
mkdir -p dist
swiftc -O -o dist/statusbar "${CLAUDE_SKILL_DIR}/add/src/statusbar.swift"

This produces a small native binary at dist/statusbar.

On macOS Sequoia or later, clear the quarantine attribute so the binary can run:

bash
xattr -cr dist/statusbar
Create the launchd plist

Determine the absolute project root and home directory:

bash
pwd
echo $HOME

Create ~/Library/LaunchAgents/com.nanoclaw.statusbar.plist, substituting the actual values for {PROJECT_ROOT} and {HOME}:

xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.nanoclaw.statusbar</string>
    <key>ProgramArguments</key>
    <array>
        <string>{PROJECT_ROOT}/dist/statusbar</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>EnvironmentVariables</key>
    <dict>
        <key>HOME</key>
        <string>{HOME}</string>
    </dict>
    <key>StandardOutPath</key>
    <string>{PROJECT_ROOT}/logs/statusbar.log</string>
    <key>StandardErrorPath</key>
    <string>{PROJECT_ROOT}/logs/statusbar.error.log</string>
</dict>
</plist>
Load the service
bash
launchctl load ~/Library/LaunchAgents/com.nanoclaw.statusbar.plist

Phase 3: Verify

bash
launchctl list | grep com.nanoclaw.statusbar

The first column should show a PID (not -).

Tell the user:

The bolt icon should now appear in your macOS menu bar. Click it to see NanoClaw's status and control the service.

  • Green dot — NanoClaw is running
  • Red dot — NanoClaw is stopped

Use Restart after making code changes, and View Logs to open the log file directly.

To uninstall, follow REMOVE.md.

© nanocoai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in .claude/skills/add-macos-statusbar of nanocoai/nanoclaw.

  • SKILL.md
  • REMOVE.md
  • add/src/statusbar.swift

Open the folder on GitHubat commit a0c79dd

Compare with similar skills

macOS Menu Bar Status for NanoClaw next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

macOS Menu Bar Status for NanoClaw compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
macOS Menu Bar Status for NanoClaw this skillnanocoai/nanoclaw31k—~780Automated safety check: PassMIT
Site ArchitectureAvdLee/RocketSimApp80611 repos~3.3kAutomated safety check: PassCustom licence
macOS Spm App PackagingDimillian/Skills4k5 repos~1.2kAutomated safety check: PassMIT
Orca iOS Simulator Controlstablyai/orca89k1 repos~584Automated safety check: PassApache-2.0
Sales EnablementAvdLee/RocketSimApp80610 repos~3.5kAutomated safety check: PassCustom licence
Apple Crash Log .NET Symbolicationdotnet/skills5.6k1 repos~2.4kAutomated safety check: PassMIT

Similar skills

  • Site Architecture

    AvdLee/RocketSimApp

    When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking.

    806 GitHub starsUsed in 11 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • macOS Spm App Packaging

    Dimillian/Skills

    Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project.

    4k GitHub starsUsed in 5 repos~1.2k tokens
    MobileAuto-check passed
  • iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…

    89k GitHub starsUsed in 1 repo~584 tokens
    MobileAuto-check passed
  • Sales Enablement

    AvdLee/RocketSimApp

    When the user wants to create sales collateral, pitch decks, one-pagers, objection handling docs, or demo scripts.

    806 GitHub starsUsed in 10 repos~3.5k tokens
    Sales & SupportAuto-check passed
  • Official

    Resolves .NET runtime frames in Apple .ips crash logs to function names, source files and line numbers using dSYM symbols, atos and the Microsoft symbol server.

    5.6k GitHub starsUsed in 1 repo~2.4k tokens
    MobileAuto-check passed
  • Revops

    AvdLee/RocketSimApp

    When the user wants help with revenue operations, lead lifecycle management, or marketing-to-sales handoff processes.

    806 GitHub starsUsed in 6 repos~3.7k tokens
    Sales & SupportAuto-check passed

More from nanocoai/nanoclaw

All 59 skills in this repo
  • Installs or refreshes Iron Proxy and its Iron Control web console for NanoClaw, with a local Docker setup, database, credentials and a human approval bridge.

    31k GitHub stars~4.6k tokensUpdated today
    Auto-check: notes
  • Installs or refreshes OneCLI as the gateway provider for NanoClaw, copying the adapter files, registering the provider and running the setup script.

    31k GitHub stars~1.1k tokensUpdated today
    Auto-check: notes
  • Agent Browser

    nanocoai/nanoclaw

    Drives a web browser from the shell with the agent-browser CLI: open pages, read an element snapshot, click and fill by reference, grab text and screenshots.

    31k GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check passed
  • Add Dial Tool

    nanocoai/nanoclaw

    Installs the `dial` CLI and a credential in NanoClaw agent containers so chosen agents can send SMS, place AI voice calls and receive verification codes.

    31k GitHub stars~4.8k tokensUpdated today
    Auto-check passed
  • Guides a conversational migration from an OpenClaw install to NanoClaw v2, carrying over identity, channel credentials, scheduled tasks and workspace files.

    31k GitHub stars~6k tokensUpdated today
    Auto-check: notes
  • Wires up an additional phone number onto an already-installed Dial channel, so one NanoClaw install answers SMS and AI voice calls on more than one line.

    31k GitHub stars~1.5k tokensUpdated today
    Auto-check passed

Works with

Questions about macOS Menu Bar Status for NanoClaw

What does macOS Menu Bar Status for NanoClaw do?

Adds a macOS menu bar icon that shows whether NanoClaw is running and offers Start, Stop, Restart and View Logs controls. A small Swift program adds a menu bar icon, a bolt with a green dot when NanoClaw is running and a red dot when it is stopped, plus Start, Stop, Restart and View Logs controls, much like Docker Desktop's menu bar entry. It is macOS only, since it uses AppKit and needs `swiftc` from the Xcode Command Line Tools.

When should I use macOS Menu Bar Status for NanoClaw?

macOS Menu Bar Status for NanoClaw fits situations like: seeing at a glance whether NanoClaw is running on your Mac; restarting NanoClaw from the menu bar after code changes; opening the NanoClaw log file without using a terminal.

How do I install macOS Menu Bar Status for NanoClaw in Claude Code?

Run `npx skills add nanocoai/nanoclaw --skill add-macos-statusbar -a claude-code`. Or copy the skill folder (.claude/skills/add-macos-statusbar in nanocoai/nanoclaw) into .claude/skills/add-macos-statusbar in your project. Claude Code loads it when a task matches its description.

How do I install macOS Menu Bar Status for NanoClaw in Codex?

Run `npx skills add nanocoai/nanoclaw --skill add-macos-statusbar -a codex`. Or copy the skill folder (.claude/skills/add-macos-statusbar in nanocoai/nanoclaw) into .agents/skills/add-macos-statusbar in your project. Codex loads it when a task matches its description.

Can I use macOS Menu Bar Status for NanoClaw in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nanocoai/nanoclaw --skill add-macos-statusbar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-macos-statusbar, .gemini/skills/add-macos-statusbar, .github/skills/add-macos-statusbar and .opencode/skills/add-macos-statusbar in your project.

What does macOS Menu Bar Status for NanoClaw need to run?

Going by SKILL.md and its folder, macOS Menu Bar Status for NanoClaw needs Swift for the scripts in its folder. Our summary lists: macOS; Xcode Command Line Tools with `swiftc`; A NanoClaw installation.

Does macOS Menu Bar Status for NanoClaw access the network?

SKILL.md names 1 domain. In commands or code: apple.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is macOS Menu Bar Status for NanoClaw safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does macOS Menu Bar Status for NanoClaw use?

macOS Menu Bar Status for NanoClaw is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does macOS Menu Bar Status for NanoClaw use?

About 780 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to macOS Menu Bar Status for NanoClaw?

Skills that share tags, products or a category with macOS Menu Bar Status for NanoClaw: Site Architecture (AvdLee/RocketSimApp, 806 stars), macOS Spm App Packaging (Dimillian/Skills, 4k stars), Orca iOS Simulator Control (stablyai/orca, 89k stars) and Sales Enablement (AvdLee/RocketSimApp, 806 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains macOS Menu Bar Status for NanoClaw?

nanocoai (a GitHub organization) maintains it in nanocoai/nanoclaw, which has 30,915 GitHub stars. The repository holds 59 skills in this directory. The repository was last updated on October 10, 2026.

Source: nanocoai/nanoclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.