Claude Coterminal — Development skill for Claude Code

claude-coterminal

Monitor and reply to your [Claude Code](https://claude.ai/code) terminal sessions from your phone via a mobile web UI. See which sessions are working, waiting for input, or done — and send replies without being at your desk.

**Why not Anthropic's built-in remote control?** It requires a stable relay connection and breaks frequently. claude-coterminal runs entirely on your machine — the only thing that leaves your network is what you explicitly tunnel.

 

---

How it works

Your phone (Safari)
      │
      │  SSH tunnel  or  cloudflared URL
      │
 ┌────▼─────────────────────────────────────┐
 │              Mac / Linux                 │
 │                                          │
 │  FastAPI server  ◄──WebSocket──► Browser │
 │       │                                  │
 │       ├── reads  ~/.claude/sessions/     │  ← live PID files written by Claude
 │       ├── reads  ~/.claude/projects/     │  ← JSONL conversation history
 │       └── reads  ~/.claude/claude-web/   │  ← state files written by hooks
 │                        states/           │
 │                                          │
 │  Claude hooks  ──────────────────────►   │
 │  (Stop → waiting, PreToolUse → working)  │
 │                                          │
 │  tmux session  ◄── send-keys ── Reply    │  ← your reply lands in the terminal
 └──────────────────────────────────────────┘

Each Claude session runs inside a named **tmux** session (started via the `cc` wrapper). Claude's own hooks fire on every state change and write a small JSON file. The server polls these files every 2 seconds and pushes updates to all connected browsers over WebSocket.

---

Install

**One-liner:**

git clone https://github.com/adamorad/claude-coterminal && cd claude-coterminal && bash install.sh

Then build the frontend and start:

cd frontend && npm install && npm run build && cd ..
bash start.sh

Open **h