A little help.
A lot more possibility.
Your phone is the conversation. Your computer does the work.
Here’s how to bring them together.
From curious to connected
Follow the guides in order, or jump to what you need.
Set up headless Linux
Install the self-contained host, open private setup over SSH, and connect your iPhone.
Sign in on your iPhone
Create an account, pair your host, recover sign-in, and use older connections safely.
Set up the Mac app preview
Account, private connection, agents, projects, and your iPhone—without cloning a repository.
Mac setup troubleshooting
Get unstuck on sign-in, Tailscale, agent checks, missing projects, or iPhone pairing.
How Handsfree works
The big picture: your computer, your phone, and the conversation between them.
Connect your computer
A picture-by-picture guide to desktop setup, the QR code, and pairing your phone.
Your first conversation
Start or resume work, with screenshots of projects, conversations, and the talking controls.
Set up your Mac & iPhone
The complete setup recipe, with commands for your host and private connection, plus native iPhone speech.
Connection & troubleshooting
Pairing, browser access, voice controls, and getting connected again.
Phone → host → phone
Trace a spoken turn: speech models, agent prompts, TTS, summaries, memory and recovery.
“Is everything controlled by voice?”
You choose the computer, project folder, and session on screen. Then you can talk or type. Hands-free mode keeps the conversation going in that selected session.
See what’s voice and what’s on screen