claudeers.
// Other

Simmer

A tiny macOS menu-bar companion for Claude Code — a pixel crab that shows session status, chimes when Claude needs you, and jumps you to the right terminal.

// Other[ cli ][ api ][ claude ]#claude#other◷ NOASSERTION$open-sourceupdated 2 months ago
Slowing down
92/100
last commit 2 months ago
last release 2 months ago
releases 5
open issues 0
// star history
★ 15 github ↗

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 Simmer (release-binary project) into my current project.
Found on https://claudeers.com/simmer
Repo: https://github.com/grantgws/Simmer
Homepage/docs: —
Detected install method: release-binary → inspect the README
Category: other. Platforms: cli, api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
slowing; 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/grantgws/Simmer/releases
// or clone
git clone https://github.com/grantgws/Simmer

// compatibility

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

Simmer

Simmer is a lightweight macOS menu bar app that surfaces the live status of your Claude Code sessions. See at a glance whether Claude is working, waiting on you, or finished — and jump straight to the session that needs attention.

Simmer demo

⬇ Download for macOS · ▶ Watch with sound

Features

  • At-a-glance status in the menu bar — working, action needed, done, or idle.
  • Multiple sessions tracked at once. The menu bar reflects the most urgent session; the dropdown lists every session with its current state.
  • Audible and visual alerts when a session needs input or finishes.
  • Jump to a session — click any session to bring its terminal window forward.
  • Local only. No account, no network, no telemetry. All state stays on your Mac.

Requirements

  • macOS 13 or later
  • Claude Code
  • Xcode (to build from source)

Install

Download (no Xcode needed):

  1. Grab Simmer.zip from the latest release and unzip it.
  2. Move Simmer.app to your Applications folder.
  3. Simmer isn't notarized yet, so macOS flags it as from an "unidentified developer." Clear the quarantine flag once, in Terminal: 
    xattr -dr com.apple.quarantine /Applications/Simmer.app
    (Or right-click Simmer.app → Open → Open.)

Or build from source (requires Xcode):

gh repo clone grantgws/Simmer && cd Simmer && ./install.sh

After installing:

  1. Open the menu bar item and choose Connect to Claude Code. This registers Simmer's hooks in ~/.claude/settings.json.
  2. Restart any running Claude Code sessions so the hooks take effect.
  3. Optionally enable Launch at Login.

How it works

Claude Code emits hooks on session events — prompt submitted, tool use, awaiting input, and turn complete. Simmer installs a small hook script that records each session's state to a per-session file in ~/.claude/simmer/sessions/. The app watches that directory and renders the aggregate status.

Connecting writes Simmer's hooks to ~/.claude/settings.json (backing the file up first and refusing to modify it if it can't be parsed). Disconnecting removes those hooks cleanly, so uninstalling never leaves Claude Code in a broken state.

Permissions

  • Notifications — to alert you when a session needs input.
  • Automation (Terminal) — used only when you click a session to focus its terminal window. Simmer can raise a window; it cannot read or type anything.

Uninstall

Choose Disconnect from Claude Code in the menu (this removes Simmer's hooks), then quit Simmer and move it to the Trash.

Building and releasing

See SIGNING.md and RELEASING.md.

License

MIT. Not affiliated with or endorsed by Anthropic. "Claude" and "Claude Code" are trademarks of Anthropic.

// faq

What is Simmer?

A tiny macOS menu-bar companion for Claude Code — a pixel crab that shows session status, chimes when Claude needs you, and jumps you to the right terminal.. It is open-source on GitHub.

Is Simmer free to use?

Simmer is open-source under the NOASSERTION license, so it is free to use.

What category does Simmer belong to?

Simmer is listed under other in the Claudeers registry of Claude-compatible tools.

0 views
★ 15 stars
unclaimed
updated 2 months ago

// embed badge

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

// retro hit counter

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

// reviews

// guestbook

0/500

// related in Other

🔓
nature-skills

符合nature论文学术表达和科研绘图的Skill

// otherYuan1z0825/⟨Python⟩★ 36,535◷ Apache-2.0[ claude ]
🔓
cmux

Open source Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents. Built for multitasking, organization, and programmability.

// othermanaflow-ai/⟨Swift⟩★ 26,069◷ NOASSERTION[ claude ]
🔓
hallmark

Anti-AI-slop design skill for Claude Code, Cursor, and Codex.

// otherNutlope/⟨CSS⟩★ 25,307◷ MIT[ claude ]
🔓
huashu-design

Huashu Design · HTML-native design skill for Claude Code · Claude Code 里 HTML 原生的设计 skill · 高保真原型 / 幻灯片 / 动画 + 20 设计哲学 + 5 维评审 + MP4 导出 · Agent-agnostic

// otheralchaincyf/⟨HTML⟩★ 23,151◷ MIT[ claude ]
→ see how Simmer connects across the ecosystem