Claude Remote — Remote Dev Environment
Work on projects from any device — Claude Code CLI + browser terminal + preview proxy, self-hosted
// Built with
docker claude-code-cli
go chi gorilla-websocket creack-pty
sveltekit
typescript xterm.js tailwindcss01 Problem
Claude Code CLI runs locally. Working on projects while away from the main workstation means either lugging a laptop, remoting in over poor- quality SSH, or losing the structured Claude-driven workflow entirely. There is no mobile-friendly path to drive real agent-assisted development from an iPad, phone, or borrowed machine.
02 Approach
Three-service docker-compose: claude-runner (Ubuntu + Claude Code CLI), api (Go + chi + creack/pty + gorilla/websocket), ui (SvelteKit + xterm.js + Tailwind). API opens a PTY against the runner container and bridges it to the browser over WebSocket. Port proxy forwards subdomain traffic to whichever port the running dev server exposed — Vercel-style preview against the user's own VPS. Same UI drives the Claude CLI `-p "<prompt>"` chat command for non-interactive flows.
03 Solution
A personal web portal fronting a Dockerised Claude Code CLI on a remote server. Browser-based terminal (xterm.js over WebSocket) talks to a Go API that proxies commands to a PTY session inside the container. A preview port proxy surfaces running dev servers Vercel-style so live previews are reachable from any device. Mobile- web demos confirm coding sessions work from a phone.
04 Outcomes
Qualitative
- Coding sessions from phone or iPad via browser terminal + live preview
- PTY-backed terminal streams real CLI output over WebSocket
- Feature-proof proved end-to-end with docker-compose up
05 Trade-offs
Hosting the CLI + preview proxy is heavier than opening a laptop, but it turns the phone into a real coding device and removes "I don't have my machine" as a blocker. Personal scope — single user, no multi-tenant auth yet. Docker isolation gives enough sandboxing for the feature-proof stage.
06 Constraints
- Feature-proof scope — minimal viable, not hardened for production
- Single user / single VPS — no multi-tenant auth yet
- Docker isolation as primary sandbox — no per-command restrictions
- Terminal + port proxy must tolerate flaky mobile networks (reconnect)
07 Innovation
Vercel-style live preview for an agent-driven development workflow, accessed through a self-hosted personal portal. Turns any device — iPad, phone, borrowed laptop — into a full Claude Code workstation without shipping the machine or losing the governed-SDLC context.
Novelty: in-house-first
