Ampel 0.3.1

A traffic light for your Claude Code sessions, in the macOS menu bar.

Signed with a Developer ID certificate and notarized by Apple, so it opens without a Gatekeeper prompt.

Install

brew trust appgineering/tap
brew tap appgineering/tap
brew install --cask ampel

brew trust comes first. Homebrew refuses to load casks from a tap you have not explicitly trusted, and reports the refusal as Cannot tap appgineering/tap: invalid syntax in tap!, which sends you looking for a problem that is not there.

Or download the zip below, unzip it and drag Ampel.app to /Applications.

First run

The menu bar icon starts gray. Open it and use the setup guide to install the Claude Code hooks; nothing is tracked until those are in place. Your existing settings and any hooks from other tools are preserved, and a timestamped backup is written first.

Real 5-hour and 7-day plan usage is opt-in under Settings, Usage.

Requires macOS 14 or later, and Claude Code.

Changes

• feat: menu bar icon size is now adjustable from Settings
• fix: version bump sed fix
• fix: restore live sessions on launch and warn on translocation
• chore: report homebrew-cask notability on each release
• fix: release notes were missing the brew trust step
• chore: date based build numbers
• docs: link the site from the readme
• docs: landing page for GitHub Pages
• docs: screenshots and a demo recording
• chore: add a release script
• docs: homebrew install instructions