A tiny, native macOS menu-bar companion for OpenCode. Know when it's thinking, when it needs you, and when it's done—without switching windows.
Start a task in OpenCode and get back to your work. A glance at your menu bar tells you everything:
| Status | What you see |
|---|---|
| Working | Smooth, slow spinner, a soft Thinking… brightness wave, and a readable elapsed timer |
| Needs you | Yellow dot + Awaiting approval, prioritised over working sessions |
| Done, unread | Blue dot + Completed until you view the session |
- All your sessions, one menu. Sessions appear directly in the dropdown, with titles and tool activity.
- One click back to the conversation. Jump to the exact session in OpenCode Desktop—not just the app.
- Native, not another dashboard. Swift + AppKit. No Electron wrapper, Dock icon, or account.
- Quiet by design. White/adaptive text, colour only where it matters, and no cycling status words.
- Local by design. No analytics or cloud service. No prompts, transcripts, source code, or credentials saved.
- Universal binary. One download for Apple Silicon and Intel Macs.
Requires macOS 12+ and OpenCode V2. Desktop integration was tested with OpenCode 2.2.0; the GUI API is experimental. V1 is not supported.
brew install --cask yiaany/tap/opencode-status-bar
open -a "OpenCode Status Bar"Or download OpenCodeStatusBar.dmg and drag the app into Applications.
Important
The initial release is ad-hoc signed, not Apple-notarized. macOS may block the first launch. After verifying the download source, use System Settings → Privacy & Security → Open Anyway. Homebrew distribution uses the maintainer's tap, not the official Homebrew cask repository.
The app includes the plugin. Add its absolute path to your global ~/.config/opencode/opencode.json (or .jsonc), preserving your existing settings and plugin entries:
OpenCode reloads configuration automatically; /reload forces a refresh. Start a task to see its status. Global installation is required for the Desktop navigation plugin. No npm package installation is needed.
For a source checkout, use /absolute/path/to/opencode-status-bar/plugin instead. If you install the app somewhere else, adjust the path above.
Leave OpenCode running. The menu bar follows its session events; click a session to return to it in Desktop. CLI/TUI sessions are tracked too, but clicking them opens Desktop, not the originating terminal window. Exact navigation currently targets Desktop's local server; remote/custom servers are not supported.
OpenCode V2 events → local plugin → small JSON status files → native menu bar
The plugin writes session IDs, titles, project paths, status labels, and timestamps under ~/.opencode/status-bar/sessions/. The app reads these files locally. A GUI plugin handles exact-session navigation in Desktop. No polling of conversations, no accessibility scraping, no model calls.
Animation targets 60 Hz with a time-based angle: smoother frames do not mean faster rotation. Reduced Motion disables the text wave. Status files expire after 24 hours; an unexpectedly terminated OpenCode run can leave a stale indicator until then.
Requires Xcode Command Line Tools and Node.js 22+ for plugin checks.
git clone https://github.com/yiaany/opencode-status-bar.git
cd opencode-status-bar
npm ci --prefix plugin
npm run check --prefix plugin
npm test --prefix plugin
./build.sh --dmg
open "build/OpenCode Status Bar.app"The build produces an ad-hoc-signed universal app and build/OpenCodeStatusBar.dmg. It does not require Swift package dependencies.
brew upgrade --cask yiaany/tap/opencode-status-barTo uninstall, remove this plugin's entry from your OpenCode configuration, quit the app, then run brew uninstall --cask opencode-status-bar (or move the manually installed app to Trash). Local status files can be removed separately. Your OpenCode sessions and configuration are never deleted by the app.
Built and maintained by Ilya · @yiaany. Independent, open-source, and not affiliated with or endorsed by the OpenCode team.
Contribute · Troubleshooting · Privacy · Homebrew
MIT licensed. This project began from an MIT-licensed menu-bar app; required attribution is preserved in third-party notices.
{ "$schema": "https://opencode.ai/config.json", "plugins": [ "/Applications/OpenCode Status Bar.app/Contents/Resources/plugin" ] }