AliceLJY

Phone Remote — Development skill for Claude Code

Development community

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

How to install Phone Remote

This entry records only its repository, not the path inside it, so there is no exact command to give. Open AliceLJY/phone-remote and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Phone Remote does

Turn your phone into a wireless keyboard + CLI launcher for a Mac. One tap opens Claude Code / Codex / any CLI, then dictate the prompt with the phone's own voice input — works where remote-desktop IME forwarding fails.

Alternatives in Development

Understand Anything — Graphs that teach graphs that impress 80.7k ★
Happy Coder — by GrocerPublishAgent - Spawn and control multiple Claude Codes in parallel from your phone or desktop 15.7k ★
Peon Ping — Warcraft III Peon voice notifications (+ StarCraft, Portal, Zelda) for Claude Code and other agents 4k ★

README

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).

phone-remote running on a phone
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.