Phone Remote — Development skill for Claude Code

phone-remote

**English** | [简体中文](README_CN.md)

Turn a phone into a wireless keyboard + shortcut pad + CLI launcher for a Mac.

Open a web page on the phone, type or **dictate** into the text box (using the phone's own keyboard/voice input), and tap buttons for arrows, Tab, Ctrl+C, ⌘ combos. Commands reach the Mac over your LAN/Tailscale and are injected as real keyboard events into whatever window is frontmost.

There's also a row of **one-tap launchers** at the top: tap one and a fresh Terminal window opens on the Mac running Claude Code / Codex / Kimi, in the working directory you picked, brought to the front for you. Together with the text box below it the loop is **launch the tool → dictate the prompt → tap "send ↵"** — without touching the Mac's keyboard.

Those three are just what I happen to use. **Put whatever CLI you like there** — aider, gemini, opencode, your own script, even `htop` or `lazygit`. Anything that runs as one shell command works; it's one row in the `APPS` table (see "Customizing buttons" below).

Running as a home-screen web app. Buttons are plain HTML — the launcher row takes whatever CLI you like, one row in a whitelist and one button in the page.

Why

When you drive a headless/remote Mac through a remote-desktop tool, **voice dictation doesn't reach it**: remote software forwards physical keypresses fine but mangles IME composition, so dictated text (especially CJK) never lands.

phone-remote sidesteps that by injecting **locally on the target Mac** instead of forwarding input across the remote session. Use the remote desktop to *see* the screen and the phone to *type* — two separate paths. Chinese text and modifier combos both work.

No app to install on the phone: it's a web page you "Add to Home Screen", so the same setup works on iPhone and Android side by side.

Install

git clone https: