Skip to content

apocohq/clawdboard

Repository files navigation

Clawdboard

Mission Control for AI Agents

Every idle agent is wasted capacity.

MIT License macOS GitHub stars

Clawdboard demo


You're running five agents. One needs approval. Two are stuck. Clawdboard sits in your menu bar and shows you which Claude Code session needs your attention. One click and you're there.

Agents in your workflowNeed Clawdboard?
1–2Probably not (yet)
3–5Yes
5+Yesterday

What Clawdboard Solves

See everything at a glance

  • Status for every session: working, waiting, needs approval, abandoned
  • Context window usage: know when an agent is running hot
  • Model and git branch display

Get there in one click

  • Focus in iTerm2: jumps to the exact terminal pane
  • Focus in VS Code: opens the right workspace window
  • Focus in JetBrains: opens the project, clicks the exact terminal tab

Works how you work

  • Remote host monitoring via SSH
  • Auto-cleanup of stale and crashed sessions
  • Native macOS: menu bar, not a browser tab

Get started

Option 1: Homebrew

brew install apocohq/clawdboard/clawdboard
open /Applications/Clawdboard.app

The hooks are set up automatically when the app runs for the first time.

To upgrade: brew upgrade clawdboard

Option 2: Build from source

git clone https://github.com/apocohq/clawdboard.git
cd clawdboard

Then open Claude Code and run /clawdboard:install — it builds the app, installs hooks, and sets up your IDE.

Option 3: Plugin marketplace

/plugins marketplace add apocohq/claude-plugins
/plugins install clawdboard@apoco-plugins
/reload-plugins
/clawdboard:install

Yes, you use Claude Code to set up your Claude Code manager. We know.

See the Setup Guide for details on what gets configured and manual installation.

JetBrains terminal tab focus

For Clawdboard to focus the exact terminal tab in JetBrains IDEs, two things are needed:

  1. Disable Claude Code's built-in terminal title — add to your ~/.bashrc or ~/.zshrc:
    export CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1
  2. Install the Terminal Tab Tailor plugin in your JetBrains IDE — this propagates ANSI title escapes to the tab name.

How it works

Clawdboard uses Claude Code's hooks system to receive real-time session events. No polling, no screen scraping, no daemon. Just hooks.

Development

Requires: Swift 6 toolchain, mise

mise run setup     # Install tools and git hooks
mise run build     # swift build
mise run run       # swift run Clawdboard
mise run test      # swift test
mise run format    # Auto-fix formatting
mise run lint      # Check formatting + lint

See CLAUDE.md for architecture details and conventions.

Watch Mode

To run the app with auto-restart on every code change:

mise run dev

Contributing

We're building fast. If you're into Swift, macOS dev, or just want better agent tooling: PRs welcome.

Star this repo ⭐

You'll get notified when we ship updates. We're shipping a lot.

Built with

Swift 6 · SwiftUI · macOS native · Claude Code Hooks API


MIT License · Website · Built for Claude Code

About

Mission Control for AI Agents

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors