Step 1 of 8
Install and pair
Install once on your Mac. Setup checks the tools, downloads the speech models, starts the service and shows a code. Scan it with the app.
$ curl -fsSL https://clankrc.com/install.sh | sh
clankrc: installed clankrc to ~/.clankrc/bin/clankrc
$ clankrc setup
whisper.cpp ok
uv ok
speech model ok checksum verified
voice model ok Kokoro
tailscale serve ok https://your-mac.your-tailnet.ts.net
service running starts at login
Scan this with Clank RC on your iPhone.
Phone paired
9:41
Connect to your Mac
Run clankrc setup there, turn on Tailscale on this phone, then scan the code it shows.
Scan pairing code
Found your Mac
Point at the code from clankrc setup
Connect to your Mac
Server address
https://your-mac.your-tailnet.ts.net
Connected to your Mac.
Speech to text and voice both run on the Mac
The phone reaches the Mac over Tailscale
Connected. Nothing to type.
Step 2 of 8
Attach an agent
In any Claude Code session, type /clankrc. The session starts listening and shows up in the phone's agent list.
> /clankrc Rebasely
● Monitor(clankrc listen --name "Rebasely")
└ clankrc[rebasely] open: Rebasely
● Listening on your phone. Answers go out with clankrc say.
9:41
Clank RC
No agent connected
On your Mac, in a Claude Code session, run:
clankrc listen --name "My task"
Or type /clankrc there if you have the Clank RC plugin.
Rebasely
No messages yet
Another agent shows up here when it connects.
One row per session. Run several at once.
Step 3 of 8
Talk
Just talk. Your words appear as the Mac hears them. When you stop, the Mac ends the turn and hands the text to the session.
└ clankrc[rebasely] open: Rebasely
● Listening on your phone. Answers go out with clankrc say.
└ clankrc[rebasely] mh3k9x2a7q4b1c0d: Hey, can you add dark mode to the settings page?
9:41
Tap the button to start. After that, just talk.
You
Listening…
Hey, can you
Hey, can you add dark mode
Hey, can you add dark mode to the settings
Hey, can you add dark mode to the settings page?
You
Hey, can you add dark mode to the settings page?ListeningHearing youListening
~1 s new words appear about once a second
A pause ends the turn, even with background noise
0.1 to 0.8 s after you stop, the final text is in the session
Step 4 of 8
Answer
The agent works and sends a short progress note. Then it answers, and your Mac's voice reads it to you.
└ clankrc[rebasely] mh3k9x2a7q4b1c0d: Hey, can you add dark mode to the settings page?
● Bash(clankrc say --id rebasely --progress "Adding dark mode to Settings.")
● Edit(src/Settings.tsx)
● Bash(npm test -- settings)
└ 14 passed
● Bash(clankrc say --id rebasely "Done. Dark mode is in, with a toggle in Settings. Want me to open a PR?")
9:41
You
Hey, can you add dark mode to the settings page?Rebasely
Adding dark mode to Settings.Rebasely
Done. Dark mode is in, with a toggle in Settings. Want me to open a PR?Rebasely is working
ListeningSpeaking
Progress notes show, then the real answer
0.5 to 1.4 s after the reply, your Mac's voice starts
Step 5 of 8
Interrupt
Talk over the reply and it stops at once. Your new words go to the agent. A cough doesn't count.
● Bash(clankrc say --id rebasely "Done. Dark mode is in, with a toggle in Settings. Want me to open a PR?")
└ clankrc[rebasely] mh3k9x5f2n8r6t1e: Wait, make it follow the system setting too.
● Read(src/theme.ts)
9:41
Rebasely
Adding dark mode to Settings.Rebasely Stopped
Done. Dark mode is in, with a toggle in Settings. Want me to open a PR?You
Listening…
Wait, make it
Wait, make it follow the system
Wait, make it follow the system setting too.
You
Wait, make it follow the system setting too.SpeakingHearing youListening
The voice stops the moment you speak
A cough doesn't interrupt it
Step 6 of 8
Show it a photo
Snap the whiteboard and say what it is. The agent gets the picture on your Mac and answers out loud. Photos and videos work both ways.
└ 16 passed
└ clankrc[rebasely] mh3k9xa30c5w2y7p: Here's the retry plan. [photo: ~/.clankrc/images/mh3k9xa30c5w2y7p.jpg]
● Read(~/.clankrc/images/mh3k9xa30c5w2y7p.jpg)
● Bash(clankrc say --id rebasely "Got it: retry three times with backoff, then the dead-letter queue. Want me to build it?")
9:41
You
Here's the retry plan.Rebasely is working
Rebasely
Got it: retry three times with backoff, then the dead-letter queue. Want me to build it?ListeningSpeaking
The camera is one tap from the chat
Photos stay on your Mac, deleted after 14 days
Step 7 of 8
Walk around
Lock the phone and put it in your pocket. It keeps listening and talking. Your voice goes only to your Mac and never leaves your machines.
● Bash(npm test -- settings)
└ 16 passed
└ clankrc[rebasely] mh3k9xd81j4m9s3u: Does it follow the system now?
● Bash(clankrc say --id rebasely "It does. All 16 tests pass. Want me to open a PR?")
└ clankrc[rebasely] mh3k9xf04k7n2q8w: Yes, open it.
● Bash(gh pr create --fill)
Wednesday, November 4
9:41
The orange dot: the mic stays on with the screen locked
You, in the kitchen: Does it follow the system now?
Your Mac's voice: It does. All 16 tests pass. Want me to open a PR?
You: Yes, open it.
No cloud. Speech stays on your Mac.
Step 8 of 8
The whole loop
Set up once in three commands. After that, talking is the whole interface.
- 1Install and pair
curl -fsSL https://clankrc.com/install.sh | sh, thenclankrc setupand scan its codeonce - 2Attach an agent
/clankrcin Claude Code, orclankrc listen --name "Rebasely"per session - 3TalkLive words about once a second; a pause ends the turn~1 s
- Text reaches the agentAfter the turn ends0.1 to 0.8 s
- 4AnswerProgress note, then the reply in your Mac's voice0.5 to 1.4 s
- 5InterruptTalk over it; a cough doesn't countinstant
- 6Show it a photoFrom the camera or your library; videos tooboth ways
- 7Walk aroundWorks with the screen locked; voice stays on your machinesalways on
Coming next
Pairing without Tailscale.