Hubbub
Your AI coding agents, as a tiny living 3D world in the macOS menu bar.
Every session is a scene. Every sub-agent is a character with a silly job.
Website · Features · Install · Themes · Screenshots · Privacy · FAQ
Unofficial. Hubbub is an independent project, not affiliated with, endorsed by or sponsored by GitHub, Microsoft, Anthropic, OpenAI, Google, Cursor or xAI. Names and logos belong to their owners (docs/IP_NOTES.md).
📑 Contents
👀 What is it?
Hubbub watches the local session logs of your AI coding agents and turns each running session into a small interactive 3D scene. Sub-agents become characters doing a themed job: chefs in a kitchen, sheep on a farm, impostors on a ship. At a glance you see who is working, stuck, failed or waiting for your approval, plus context, tokens, cost and quota. It lives in the menu bar and opens as a popover (or a bigger window with ⌘E).
✨ Features
Each session is a stage; the main agent is the lead (Commander, Farmer, Head Chef…) and every sub-agent (explore, task, review…) gets a nameplate, a job and speech bubbles. Stuck, failed and approval-needed states are visible on the stage, not just in a list.
Software Office (default), Space Station, Restaurant Kitchen, Prison, Football Match (fictional clubs), Sheep Farm, Sneaky Ship, Spell Academy, Galactic Fleet and Hillside Quest. All procedural SceneKit art; see the gallery. Community themes are a JSON file away (docs/THEMES.md).
Copilot shows a quota bar (needs a GitHub token; uses an undocumented endpoint, see caveats). Cost is shown as Copilot credits as reported in the logs. Hubbub does not invent dollar prices; any dollar estimate only comes from a price table you source yourself and is labelled "est." (docs/COST.md). Other providers show token totals.
Live tab with tokens, context and cost; a searchable History; Insights with a weekly chart; Details per session (tool calls, failure rate); and an Awards tab for level, XP and badges.
Answer an agent's question or approve/deny from the menu bar. Off by default; delivery to real terminals is not yet verified everywhere, see docs/REPLY.md.
Drag the stage to orbit, right-drag (or ⌥-drag) to pan, scroll/pinch to zoom (the fit button resets the view). Updates install in-app with one click ("Update and Restart"). Each theme splits the map into three themed rooms (e.g. stove line, prep and dish pit in the kitchen) with live "working" counts on signs, and every agent gets its own coloured bay. Also: fullscreen view, jump to a fullscreen view, and enjoy subtle time-of-day and weather ambience (switchable in Settings).
A mascot per theme, levels, XP, badges and cosmetics. Optional surprise guests, race mode, sounds and a floating mini HUD (all off by default).
Pumpkins, ghosts and bats over every theme, plus cobwebs and a spider in the app UI. Off by default: set Auto (Oct 24 – Nov 1) or On in Settings → Appearance (docs/HALLOWEEN.md).
Copilot CLI, Claude Code, Codex CLI, Gemini CLI, Cursor and a generic event format, each with a provider badge. The menu-bar item can show quota percent. VoiceOver narration of the stage, status by icon as well as colour, and Reduce Motion / Contrast / Transparency support.
📦 Install
Universal app: Apple silicon and Intel. Free, no account needed.
- Download
Hubbub.dmg (button above) and open it.
- Drag Hubbub to Applications in the window that appears.
- Open Hubbub from Applications. A small icon appears in the menu bar (there is no Dock icon).
Hubbub is signed with an Apple Developer ID and notarized, so it opens with no warning. If macOS still complains
(e.g. a build you compiled yourself), go to System Settings → Privacy & Security → Open Anyway.
Requires macOS 14 (Sonoma) or later. Prefer Homebrew? brew tap karakayautku4/hubbub && brew trust karakayautku4/hubbub && brew install --cask hubbub (recent Homebrew asks you to trust third-party taps; see packaging/homebrew).
Needs a Swift toolchain (Xcode or Command Line Tools).
git clone https://github.com/karakayautku4/hubbub.git
cd hubbub
./build-app.sh # builds Hubbub.app (ad-hoc signed; releases are Developer ID signed + notarized)
open Hubbub.app
./make-dmg.sh # optional: universal DMG in dist/ (see docs/RELEASING.md)
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
