C
srcindex.tsutils/
linttestbuilddeploy
+~+PR #42

You're running !|
Claude Code is in your pocket.

Your agent keeps building while you live your life.
Stay in control from your phone.

Apache 2.0Open SourceSelf-hostable

Everything you need. Nothing you don't.

9:41

(bep)codes - your GH projects

Connected

live
what's left in the auth PR?
C
The auth PR has 3 remaining items:

1. Token refresh in auth.ts:142
2. Rate limiting middleware
3. Unit tests for edge cases
fix the token refresh and run tests
C
On it. Updating token refresh
Message Claude...

Real-time streaming

Token-by-token over WebSocket. Responses appear as Claude types, no polling, no waiting.

Autonomous tasks

One message. Claude edits files, runs tests, commits, and opens PRs, without interrupting you.

Push notifications

Get pinged when tasks finish, tests fail, or PRs are ready for review.

Open source

Apache 2.0 licensed. Read the code, fork it, self-host the relay. No black boxes.

Behind the scenes

A minimal relay, your code never leaves your machine.

📱

Your Phone

iOS / Android

WebSocket

☁️

Cloudflare Relay

Workers + Durable Objects

WebSocket

🖥️

Agent Daemon

your machine

local IPC

$_

Claude CLI

claude code

Your code never leaves your machine

The relay only passes encrypted messages. No source code, no files, no secrets.

Zero database

No data stored in the cloud. The relay is stateless — it just routes messages.

Apache 2.0 Licensed — fully open source

Read the code, fork it, self-host it. No black boxes.

Up in 4 steps

No accounts, no API keys beyond what Claude Code already uses.

00
Preparation

Choose where to run the agent

The agent daemon runs on a machine with Claude Code installed. Pick the option that fits your setup — you can always switch later.

💻

Local machine

Run the agent on your dev machine. No extra cost — uses the machine you already work on.

Must stay powered on

Recommended
☁️

VPS

A cheap VPS (e.g. Hetzner CX11 ~€4/mo) stays online 24/7. Your agent is always reachable.

Always available

01

Deploy the relay

One command deploys the Cloudflare Worker that bridges your phone and agent.

terminal
# Clone and deploy the relay
$ git clone https://github.com/you/claude-on-mobile
$ cd relay && npx wrangler deploy
Uploading... ████████████ 100%
Deployed to relay.your-name.workers.dev
02

Start the agent daemon

Run the agent on your machine. It connects to the relay and proxies Claude CLI.

terminal
# Install and start the agent
$ npx @claude-mobile/agent setup
Relay URL: relay.your-name.workers.dev
Generating pairing code...
Agent ready • Pairing code: 847-293
$
03

Pair your phone

Download the app, tap "Connect", enter the 6-digit code. Done.

App Store
Google Play

Enter pairing code

8
4
7

Stored securely in Keychain / Keystore

11:23am

Your agent is waiting.

Deploy the relay, start the daemon, pair your phone.
Then close your laptop and let Claude work.