Mudo — Productivity skill for Claude Code

MuDo

MuDo is a small always-on-top macOS widget that shows the Claude Code and Kiro CLI sessions running on your remote Linux servers, so you never forget an agent that finished while you were doing something else. Each session is `idle`, `running`, `waiting` (for a permission prompt) or `done`. A session that finished and is left unseen for a few minutes blinks until you act on it. Clicking a session brings its code-server tab in Google Chrome to the front.

Linux server (each one)                                   Mac
┌──────────────────────────────────────────┐
│ claude / kiro-cli                         │
│   └─ hook: mudod hook --agent claude|kiro │
│        └─ POST 127.0.0.1:7878/event       │
│                   ▼                       │
│ mudod serve  (systemd --user)             │
│   - session state machine                 │
│   - PID liveness check every 10 s         │
│   - ~/.local/state/mudo/state.json        │     ┌─────────────────────┐
│   - API on api_addr :7879 (bearer token) ─┼SSE─▶│ MuDo.app (SwiftUI)  │
└──────────────────────────────────────────┘     │ one stream / server │
                                                  └─────────────────────┘

• server/: mudod, a single static Go binary (linux/amd64): agent hooks, daemon, installer.
• app/: MuDo.app, a SwiftUI macOS app with no third-party dependencies.
• Design spec: docs/superpowers/specs/2026-10-14-mudo-design.md.

Requirements

**Server**

• Linux amd64 with a systemd user session (lingering enabled so the daemon survives logout).
• Claude Code and/or kiro-cli.
• Optional: code-server opened in Google Chrome, one window per project, so clicking a session can focus it.

**Mac**

• macOS 26 or later.
• Xcode 26 (or its command line tools) to build the app.
• Google Chrome (for focusing code-server tabs).

**Network**: the Mac must reach the server on TCP 7879, over Tailscale or the LAN. Traffic is plain HTTP with