rheinard.korf.au

← All projects

Muxdash

A tmux dashboard for what's waiting on you, from pull requests and alarms to meetings and Claude Code sessions.

Muxdash puts everything that’s waiting on you in one tmux session: pull requests, CI runs, tickets, alarms, meetings, feeds and your running Claude Code sessions. Each part of your work gets a window, and each window holds lists you can search, with a preview beside them. The lists never wait on the network, so they open instantly and still work offline.

A look at each window, from GitHub to Claude Code sessions, then the assistant. Partway through, a pull request's failing check is fixed, and it comes back marked ◆. The data is made up for an invented company, and the assistant's voice is off.

How it works

  • Only one part talks to the outside world. A fetcher calls GitHub, Jira, AWS, Google Calendar and your feeds on a timer, and writes what it finds to a local cache. The lists, their previews and the assistant read only that cache.
  • Quiet unless something changed. An item is marked ● when it’s new and ◆ when it has changed since you last looked. Each source decides what counts as a change: a recurring meeting is tracked as one series, and a queue only when its dead-letter queue gains messages.
  • Sources are small scripts. The engine only knows items (an id, title, status, time and link), so adding a service means writing one script. Yours sit beside the built-in ones and can replace them.
  • It knows what your agents are doing. Claude Code hooks tell Muxdash when a session finishes or is waiting on a permission prompt, and one key jumps to that session’s tmux pane.
  • An assistant for show. muxdash hud opens a full-screen briefing over everything, read aloud by an offline voice.
  • A Claude skill. It answers “what’s waiting on me?” from the cache, without calling any services.

Sources and the assistant

Most sources use their service’s own command-line tool, signed in as you.

Source Shows
GitHub Pull requests to review and your own, Actions runs with their recent history, and contribution stats
Needs gh
Jira Searches and live SLA timers
Needs acli
AWS CloudWatch alarms with a 24-hour graph, CloudFormation stacks, DynamoDB tables and SQS queues
Needs aws
Google Calendar Today and the next few days, with a countdown and your reply
Needs gog, read-only
RSS Feeds with pictures, and a read-later list
Needs Python and uv; kitty for the pictures
Claude Code Running sessions and their sub-agents, and which ones are waiting on you
Needs Claude Code hooks
Feature flags Flags kept in DynamoDB, with a key to switch them on or off
Needs aws
The assistant A full-screen briefing over all of it, read aloud
Needs Python; the Kokoro voice through uv, or macOS say

Built with

zsh, tmux, fzf, jq and glow, with Python for the assistant and feeds. It runs on macOS.

Status

Muxdash started in my dotfiles and was ported out into its own project. Used every day, and published under the MIT licence in November 2026. Expect changes.

Muxdash on GitHub

← All projects