Claude Code Remote

Claude Code Remote

Monitor and control [Claude Code](https://github.com/anthropics/claude-code) from your phone — live process view, remote approvals, question answering, and queued prompts.

[](https://github.com/alipbudiman/claude-code-remote/actions/workflows/build-apk.yml) [](https://github.com/alipbudiman/claude-code-remote/actions/workflows/build-server.yml) [](LICENSE)

What is this?

A small Go server runs on your PC and captures Claude Code hook events — tool calls, sub-agents, questions, permission requests, and completions. The Android app streams the live status, shows every step Claude is executing (including its thinking), and raises heads-up notifications; it runs as a foreground service, so tracking keeps working after you close the app or lock the phone.

The app is not just a viewer. When Claude needs a decision — a permission approval, a multiple-choice question, a plan review — the request appears on your phone and your answer is delivered straight back into the Claude Code session on your PC. You can also queue a follow-up prompt while Claude is still working, and edit Claude Code's permission rules without touching the terminal.

Everything works over local Wi-Fi with no internet required, and an optional relay (deployable on Railway) extends the same monitoring and control to any network. Sessions end in an explicit "✅ Task completed" state instead of a guess, and alerts you missed while offline are replayed on reconnect. Every connection is gated by a token that never leaves your machines.

How it works

Claude Code CLI
   │  hook events (tools, thinking, questions, completions)
   ▼
Hook bridge — ~/.claude/claude-remote-hook.js
   │  HTTP to the s