Tranquility Base banner
robertnowell robertnowell

Tranquility Base

Development community

Description

Voice loop for terminal coding agents: spoken actionable summaries of finished Claude Code turns, voice replies typed back into the originating tab, verified by transcript read-back

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Tranquility Base

A macOS menu-bar app that turns a fleet of terminal coding agents into a voice loop. When a Claude Code session finishes a turn it **hails you by name** — a chime and its own callsign, in its own voice — and then waits. Press ⌃⌥ and it reports: what concluded, what it proposes next, and the decision it needs, in about twenty-five words. Answer out loud. Your reply is transcribed, typed into the originating terminal tab, and **verified against the session transcript** so you know it landed.

The point is not dictation. It is that you can run ten sessions and supervise them without reading ten walls of text or hunting for the tab that's blocked on a permission prompt.

Other Claude Code voice tools speak: some announce that a turn ended, a few generate real spoken summaries. What none of them do is impose a **protocol** — hail and standby, callsign-first attribution, a proposal that ends on a one-word decision, and a pull ladder for the detail you didn't get. That protocol is the product, and it is borrowed, deliberately, from the room that solved this problem in 1969.

The loop

turn ends ─▶ chime + "promotions copy"          the hail: name only, then standby
                     │                          (never interrupts anything)
        ⌃⌥ ─▶ "…finished the poller. Propose adding the Shopify filter. Go?"
                     │                          12-word recap + <15-word proposal
        ⌃⌃ ─▶ FINDINGS ▸ SOLUTION ▸ WHY ▸ MESSAGE     the ladder, ~40 words a rung
                     │                          zero extra model calls
   hold ⌥, speak ─▶ 4s undo window ─▶ typed into the tab ─▶ read back to confirm

Silence means nominal. Nothing speaks unless a session is waiting on you.

Gestures

Input Action
⌃⌥ tap Hear the newest waiting session (press again to skip on)
⌃⌃ tap Walk the ladder on what you just heard — findings, solution, why, then the original message
hold Push-t