robertnowell

Tranquility Base — Development skill for Claude Code

Development community

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.

How to install Tranquility Base

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

What Tranquility Base does

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.

Alternatives in Development

Speech — Generate spoken audio from text using OpenAI's API with built-in voices 14.6k ★
ExportProfile — Generate a complete personal profile summary of everything you know about me from our conversations 250 ★
Vox Collage Broll — Turn one spoken line into a paper-collage explainer video — Claude Code skill + MaxFusion MCP 198 ★

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