claudeers.
// Automation & Workflows

muster

Never keep an agent waiting. A free, open-source Mac menu bar app for Claude Code, Codex and Cursor: see which session needs you and answer it with one keyst…

// Automation & Workflows[ cli ][ api ][ desktop ][ claude ]#claude#ai-agents#ai-coding#anthropic#appkit#claude-code#claude-code-hooks#codex#automation◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
100/100
last commit about 1 month ago
last release about 1 month ago
releases 8
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up muster (release-binary project) into my current project.
Found on https://claudeers.com/muster
Repo: https://github.com/josefchen/muster
Homepage/docs: https://agentmuster.app
Detected install method: release-binary → inspect the README
Category: automation. Platforms: cli, api, desktop.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (release-binary)

Grab the latest release asset from GitHub.

# download a build from https://github.com/josefchen/muster/releases
// or clone
git clone https://github.com/josefchen/muster

// compatibility

Platformscli, api, desktop
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageSwift

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Muster

Muster

Never keep an agent waiting.
A free, open-source Mac menu bar app for your Claude Code, Codex and Cursor sessions.

Download for Mac · brew install --cask josefchen/tap/muster · agentmuster.app · Changelog · 简体中文

Claude Code and then Codex ask to run a command. Muster's alert shows the newest first with its keys along the bottom; ⌥↓ unfolds why Codex asks, and ⌥↩ answers each in turn.

Two agents ask. ⌥↓ shows why, two presses of ⌥↩ answer them, and you never left what you were doing. Recorded from the app.

If you run a few coding agents at once, the slow part isn't the agents. It's noticing which one has been waiting on you for ten minutes. Muster sits in the menu bar, tells you the moment one needs you, and lets you answer without switching apps.

See who needs you.
A glass alert at the top of the screen the moment an agent waits on you. It stays until you answer.

Answer from anywhere.
Allow a command or pick an answer with ⌥↩, or right from the notification. The alert shows its keys.

See why before you answer.
⌥↓ unfolds the agent's reason, the whole command, or every option with its note.

Your keys stay yours.
Muster takes its keys only while something on screen needs them, and lets go while you type elsewhere.

⌥Tab to any agent.
Most urgent first. Let go to land in its window, or the terminal it runs in.

Find any session.
⌃⌥Space searches the last three hours, with tokens and API-rate cost for each.

The alert unfolded with ⌥↓ on a question from Claude Code: three options, each with the agent's note, answered with ⌥1 to ⌥3

Hold ⌥ and tap Tab to move through sessions, most urgent first, then ⌥↩ answers the one waiting

Search every session with ⌃⌥Space

Native AppKit and Liquid Glass · 2 MB download · about 0.4% CPU and 20 MB of memory with ten agents busy · no accounts, no analytics · MIT


Install

Download Muster.dmg and drag it to Applications, or:

brew install --cask josefchen/tap/muster

macOS 14 or later, Apple silicon or Intel. Liquid Glass needs macOS 26.

Answer prompts from Muster

Turn it on per agent in Settings → Answer prompts from Muster.

What you can answer
Claude CodePermission requests, multiple-choice questions, plan approvals
CodexApproval requests (trust the hook once with /hooks in Codex)
CursorOpens the prompt in Cursor

Muster adds one hook to the agent's own settings and removes exactly that when you turn it off. Beside the file it keeps .muster-original, the file as it was before Muster first changed it, and .muster-backup, the file before the latest change. A symlinked settings file stays a link, and a file Muster can't parse is left alone. Claude's native dialog stays live alongside Muster, and the first answer wins. If Muster isn't running, the agent asks as usual. Hooks talk to Muster on 127.0.0.1 with a per-install token.

Shortcuts

Keys
⌥ TabSwitch. Tap to step, release to open, or click a row
⌥ ↩ · ⌥ ⌫ · ⌥ 1–9Allow · deny · answer the prompt on the alert or in the switcher
⌥ ↓ · ⌥ ↑Unfold the alert's details · fold them
⌃ ⌥ SpaceSearch every session

Muster takes ⌥↩, ⌥⌫, the arrows and the digits only while a prompt or the switcher is on screen, and lets go of them while you type in another app, so they keep working in your editor. Both shortcuts can be changed in Settings. Scripting: muster://search, muster://next, muster://settings, muster://welcome, muster://whats-new.

Why not just a notification?

Claude Code can notify you on its own in some terminals, and a few lines of settings add a sound or a banner anywhere else; this guide compares every option. A notification tells you that something happened. With several sessions running you still have to work out which one, find its window and type the answer. Muster shows which one, answers it from where you are, and does the same for Codex and Cursor.

How it works

Muster reads the session files each app already writes. Nothing to configure.

AppRead from
Claude (desktop, CLI, SSH sessions)~/.claude/projects transcripts and Claude's session list
Codex (app and CLI)~/.codex/state_*.sqlite threads and rollout logs
CursorThe Agents window's chat list and agent transcripts

Everything is opened read-only. File system events trigger a rescan, at most once a second; transcripts are read incrementally, only the bytes added since the last look.

Cost estimates

Public list prices for the standard API tier, bundled and dated in Settings. Claude is priced message by message, including subagents, with 5-minute and 1-hour cache writes kept apart. Codex is priced from its running totals; OpenAI's long-context tier isn't applied, so Codex figures are a floor. Cursor records no token counts on disk.

Use your own prices from Settings → Use my own prices…, which writes ~/Library/Application Support/Muster/pricing.json.

Privacy

No accounts, no analytics. The only network request is the update check, which happens when you click Check for Updates or turn on the daily check, and asks GitHub for the latest release. The prompt server listens on 127.0.0.1 only and needs a token that lives in your user defaults and the agents' hook settings.

Build from source
git clone https://github.com/josefchen/muster.git && cd muster
./build.sh            # build, install to ~/Applications, launch
./test.sh             # reader tests against fixture files
scripts/e2e.sh        # end-to-end: the real app against a fake home folder

scripts/e2e.sh drives the built app the way the agents and you would (transcripts, hook requests, the switcher, deck and alert) without touching your own agents or settings; --soak [minutes] checks CPU and memory under load, and --ui replays real keystrokes and clicks (it takes over the keyboard while it runs).

scripts/release.sh <version> builds a universal, signed and notarized DMG and writes its GitHub release notes from CHANGELOG.md, and scripts/site.sh deploy publishes agentmuster.app and its changelog page to Cloudflare. scripts/capture-stills.sh, scripts/record-scene.sh, scripts/record-answer.sh and scripts/tour.sh regenerate the screenshots, the videos and the welcome tour from demo mode (Muster --demo). Muster opens and plays each scene itself, so they need Screen Recording and nothing else.

See CONTRIBUTING.md.


MIT License. Muster is independent and not affiliated with Anthropic, OpenAI or Anysphere.

// faq

What is muster?

Never keep an agent waiting. A free, open-source Mac menu bar app for Claude Code, Codex and Cursor: see which session needs you and answer it with one keystroke.. It is open-source on GitHub.

Is muster free to use?

muster is open-source under the MIT license, so it is free to use.

What category does muster belong to?

muster is listed under automation in the Claudeers registry of Claude-compatible tools.

19 views
★ 58 stars
unclaimed
updated about 1 month ago

// embed badge

muster on Claudeers
[![Claudeers](https://claudeers.com/api/badge/muster.svg)](https://claudeers.com/muster)

// retro hit counter

muster hit counter
[![Hits](https://claudeers.com/api/counter/muster.svg)](https://claudeers.com/muster)

// reviews

// guestbook

0/500

// related in Automation & Workflows

🔓

The agent that grows with you

// automationNousResearch/⟨Python⟩★ 264,763◷ MIT[ claude ]
🔓

The API to search, scrape, and interact with the web at scale. 🔥

// automationfirecrawl/⟨TypeScript⟩★ 199,533◷ AGPL-3.0[ claude ]
🔓

🌐 Make websites accessible for AI agents. Automate tasks online with ease.

// automationbrowser-use/⟨Python⟩★ 121,235◷ MIT[ claude ]
🔓

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

// automationLeonxlnx/⟨JavaScript⟩★ 110,676◷ MIT[ claude ]
→ see how muster connects across the ecosystem