self-hosted · open source · MIT
RoamCode streams the real claude TUI from your machine to any browser. Your subscription, your hardware — no cloud in the middle.
You started a 40-minute refactor. Now you have to leave. Your agent shouldn't notice.
playground
A replay of a real session — same renderer the app ships (xterm.js), same key bar. Go ahead, type something.
Replay, not a sandbox — the real thing attaches to a live claude on your own machine. Sessions run in tmux: close the tab, land at your desk, pick up mid-thought.
ergonomics
Termux-style key bar — Esc, Tab, arrows, a sticky Ctrl that turns your next tap into a chord. Two fingers scroll the transcript. Tap-to-select copies.
Full-screen TUIs are miserable on glass. This is the part everyone else skipped.
splits
On desktop, drag sessions into panes. Three claudes on three repos, one glance. Each pane is a live session — not a screenshot of one.
presence
The rail reads each session's screen: working, blocked on you, done. Push notifications deep-link straight into the session that asked.
Walk away. The phone buzzes only when your hands are actually required.
ROAMCODE
claude needs you
api — “Do you want to proceed?”
trust
RoamCode is a small server you run on your own machine. The only party in the loop is you.
Drives the claude CLI you already log into. No keys uploaded, no per-token markup.
32-byte access token, CSWSH-safe WebSockets, rate limiting. Public exposure is your explicit choice.
The server phones home to exactly one place: your own git remote, when you ask it to update.
Small TypeScript monorepo. The security-relevant paths are documented and tested.
install
needs macOS or Linux · Node ≥ 24 · tmux · the claude CLI — prints a connect link for your phone. Manual path →