Join the Ship

It's free. All I ask in return is that you join the Captain's Log, my newsletter: one or two emails a week, unsubscribe anytime. Joining unlocks every download.

All downloads

A bronze airship captain at the helm glances down at one long brass console strip of glowing indicator lamps, small dials and ticker tape, with brass automatons at the side stations at blue hour.
A Claude Code reply ending in a focus footer, the prompt, and below it the three-row status box with FOCUS, the start time, a sentence in orange, and the context, folder, issue IDs and in and out counts. All data is made up. A Claude Code reply ending in a focus footer, the prompt, and below it the three-row status box with FOCUS, the start time, a sentence in orange, and the context, folder, issue IDs and in and out counts. All data is made up.
The first version: three lines showing the last prompt, the task in flight with its current step, and the last files read, edited and sent. All data is made up. The first version: three lines showing the last prompt, the task in flight with its current step, and the last files read, edited and sent. All data is made up.
The October 4 version: a thirteen-row block with a gray border, a sentence about the task, the start time, the last push, and PULL and PUSH meters for the last hour. The October 4 version: a thirteen-row block with a gray border, a sentence about the task, the start time, the last push, and PULL and PUSH meters for the last hour.
The same status box in a narrow window: the sentence wraps to two lines, and only the context number and the in and out counts are left on the bottom border. The same status box in a narrow window: the sentence wraps to two lines, and only the context number and the in and out counts are left on the bottom border.
The first tower: a double-height header with a red clock, comms grouped by project on the left, the focus mode and launch stages below it, decisions waiting on the right, and a scrolling LIVE ticker with a legend at the bottom. All data is made up. The first tower: a double-height header with a red clock, comms grouped by project on the left, the focus mode and launch stages below it, decisions waiting on the right, and a scrolling LIVE ticker with a legend at the bottom. All data is made up.
Today's tower in paper and ink: numbered route tabs, a next actions list with approvals and holds, project lines drawn as subway stops, and a service ticker along the bottom. All data is made up. Today's tower in paper and ink: numbered route tabs, a next actions list with approvals and holds, project lines drawn as subway stops, and a service ticker along the bottom. All data is made up.

TL;DR

  • This starter draws the same kind of box: a sentence in orange, the context percentage, the folder and your 5-hour limit.
  • It's 76 lines of Python with nothing to install, and it runs on Python 3.9 or newer.
  • First, the script runs on your machine and never talks to the model, so in the docs' words it "does not consume API tokens."

What's inside

  • hud.py The starter box
  • settings.json Point Claude Code at it
  • focus-footer.md A focus footer
  • change-status-line.md Change my status line
  • local.hud-collector.plist A collector every 15 minutes
  • sample.json Made-up data
  • focus.json Made-up data
  • note.txt Made-up data
  • README.md Build your own

How to use

  1. Save hud.py as ~/.claude/hud.py, then add settings.json to ~/.claude/settings.json.
  2. Name the tab. Run /rename in Claude Code and the box shows that name. Without a name, it shows the title Claude Code generates for the session.
  3. Pin a sentence. Ask Claude to run python3 ~/.claude/hud.py now "Draft the Sunday newsletter". Claude Code passes each tab's session ID to the commands it runs, so the sentence shows only in that tab. Run it in a plain terminal instead and it shows in every tab.
  4. Add a source. Anything a script writes to ~/.claude/hud/note.txt shows in the bottom right. That's the hook for a collector.
  5. If you want one, paste focus-footer.md into your CLAUDE.md.
  6. Here's a minimal one that runs a collector every 15 minutes. Save local.hud-collector.plist as ~/Library/LaunchAgents/local.hud-collector.plist.
  7. Replace YOU with your username, because launchd doesn't expand ~. Load it once with launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/local.hud-collector.plist.