macOS · VOICE CONTROL LAYER

Speak in. Code out.

Dictate, format, ask, remember, and dispatch work — from one always-available macOS overlay. Not voice typing. A voice interface to your tools and your agents.

structured intent ● local whisper

Analyze the repo for duplicate event-dispatch — propose a minimal patch.

handed to your agent · run started 2.4s · local

Install from source See the modes

NOT A WINDOW YOU SWITCH TO

It lives over your work.

Summon the overlay with a hotkey on top of whatever app has focus — your editor, the browser, TextEdit. Speak, and the result lands right where you're working.

codescribe dictation overlay — final transcript

· global hotkeys · frontmost-app aware · pastes into focus · a real macOS overlay

ONE INTERFACE

Every way you want to speak.

DICTATION

“just get this thought down before I lose it”

pasted into your editor · live preview

Dictation

Hold Fn, speak. Live preview, then it pastes into the app you're in.

Formatting

An AI pass cleans punctuation and structure — your meaning untouched.

Agent Chat

A persistent conversation — ask, refine, attach context, come back later.

Selection-aware

Highlight anything, say what to do, get the result back in place.

IT'S NOT JUST TRANSCRIPTION

Messy out loud. Clean on the page.

RAW SPEECH

dobra zróbmy tak najpierw sprawdź ten plik potem zobacz testy i nie rozwal scope

FORMATTED

Dobra, zróbmy tak: najpierw sprawdź ten plik, potem zobacz testy — i nie rozwal scope.

Punctuation, capitalization, paragraphs, artifacts removed. Meaning kept exactly.

WORKS OVER ANY APP

Select. Speak. Done.

Highlight text anywhere, say what to do, and the result drops back in its place — no copy, no chat window, no context-switch.

Mail — reply draft

Hey, yeah we can do the call. i think tuesday works but maybe later is better idk, lmk what suits u Talk soon.

Mail — reply draft

Hey, yeah we can do the call. Tuesday works for me, though a later slot would be preferable. Please let me know what suits you. Talk soon.

"fix the grammar" "summarize this" "translate to Polish" "explain this code" "turn into a checklist"

CONTINUITY

A persistent agent,
not a disappearing
prompt box.

Talk to an agent that stays with your work. Ask, refine, attach files, follow up — and restore a thread when you need it again.

· streaming· thread memory· restore

codescribe agent chat — voice-dispatched PR review: tool activity, reasoned reply, agent run started

WORKING HISTORY

Your voice doesn't disappear.

codescribe threads / voice history rail with restore

· Today / This week / Older · search · favorite · restore / copy / edit · export markdown

PERSONALIZATION

Make the agent yours.

Edit the prompts that drive formatting and assistive mode. Your voice. Your rules. Your agent.

codescribe Settings — Prompt editor: formatting.txt and assistive.txt

formatting.prompt edit · save · reset

Keep my meaning exactly. Short sentences.
Prefer bullet points for lists. Never touch
code blocks. Always keep the original language.

assistive.prompt edit · save · reset

Return only the result, no preamble. Respect
scope — don't expand the task. Be operational.
Match my tone. Output a ready-to-run patch.

AGENT-STACK READY

Speak tasks into your agent stack.

Native tools and MCP support turn spoken intent into structured input for agent runtimes — a voice control layer for VibeCrafted-style workflows.

clipboard selection screenshot file read type text GitHub fetch thread search + MCP tools

power-user · dispatch "run a repo check and prepare a minimal patch plan."

Your voice becomes
the control layer.

Not a tool you open. A layer that sits over everything you already do — and turns talking into doing.

Install from source

BUILT FOR macOS · APPLE SILICON

A real native app. No web wrapper.

A menu-bar tray, a floating overlay, and a settings window that tells you the truth — local-first STT, permissions, and runtime state at a glance.

Dictation overlay — listening · live waveform · local whisper

Menu-bar tray — show agent, history, notes, diagnostics

Shortcuts — one gesture per mode, applies live, no restart

Keys — stored in the macOS Keychain, write-only, never shown back

SETUP · 12-STEP WIZARD, SIX MOVES

Onboarding in six moves.

First launch to a ready voice runtime — pick a lane, grant permissions, set language, connect a provider, choose hotkeys, check readiness.

codescribe onboarding — step 1: operating lane, Basic or Agentic

01 Operating lane Basic or Agentic

codescribe onboarding — step 2: screen recording, permission granted

02 Screen recording permission · granted

codescribe onboarding — step 3: dictation language, auto-detect

03 Dictation language auto-detect

codescribe onboarding — step 4: AI provider, OpenAI · Keychain

04 AI provider OpenAI · Keychain

codescribe onboarding — step 5: trigger hotkeys, hold · toggle · hybrid

05 Trigger hotkeys hold · toggle · hybrid

codescribe onboarding — step 6: agentic readiness, provider · tools · MCP

06 Agentic readiness provider · tools · MCP

— from first launch to a ready voice runtime —

macOS · APPLE SILICON · v0.12.2

Local-first. Cloud opt-in.

$ git clone https://github.com/vetcoders/codescribe.git
$ make install
$ codescribe --version

· local whisper preview · configurable final pass · tray + overlay · FSL-1.1-ALv2