Tool
Claude Code in your pocket.
Run Claude Code on Android via Termux with two-way communication between your phone and desktop over Tailscale. Voice commands, QR auth, and a full task protocol.
Your phone talks to your desktop. And back.
Phone and desktop each run a lightweight HTTP channel server. The phone listens on port 8788, the desktop on 8789. Either side can send tasks to the other over your private Tailscale network — no cloud relay, no port forwarding.
Send a task from your desktop and the phone-side Claude executes it. Walk away from your desk and use voice to dispatch work back to your workstation. Both directions, same protocol.
$ # Desktop sends task to phone
curl -d '{"task_id":"t1","type":"exec",
"body":"check battery"}' http://phone:8788
<channel source="desktop-channel">
Battery: 87%, charging
</channel>
$ # Phone sends result back to desktop
{"task_id":"t1","type":"result",
"body":"Battery at 87%"}
Up and running in three steps.
Install Termux
Install Termux from F-Droid on your Android device. Set up storage access and install Node.js — the only runtime dependency.
Setup Claude
Install Claude Code in Termux and authenticate via QR code — scan from your desktop browser, no manual token typing on a phone keyboard.
Connect
Join both devices to your Tailscale network. The channel servers start automatically and discover each other by IP. Start sending tasks.
What you get.
Bidirectional channels
Phone runs a channel server on port 8788, desktop on 8789. Either side can send exec, query, or result messages to the other over Tailscale.
QR code auth
Transfer your Claude authentication to the phone by scanning a QR code. No pasting tokens into a tiny keyboard. Works with any terminal that renders QR.
Voice agent
Speech-to-text captures your voice, Claude processes it, and TTS reads the response back. Hands-free interaction with your full Claude Code environment.
Termux integration
Full access to Termux APIs — SMS, camera, location, clipboard, notifications, contacts, flashlight. Claude can use your phone as a sensor platform.
Install
Requires an Android device with Termux (F-Droid), Tailscale, and Node.js.
Install Termux and dependencies
pkg install nodejs-lts git
Install Claude Code
npm install -g @anthropic-ai/claude-code
Clone and set up termux-claude
git clone https://github.com/softwaresoftware-dev/termux-claude && cd termux-claude && make install
Transfer auth via QR code
make auth-qr