Remote control
your dev sessions.

A self-hostable daemon that lets you start, steer, and watch AI coding sessions from your phone. Pair once, control from anywhere.

shellmate
ShellMate TUI — provider selection, MCP install, pairing
Get running

Install

One global npm package. That's it. No Docker, no config files.

npm i -g shellmate

Run it

Run shellmate and the TUI walks you through everything — pairing, provider selection, sessions.

Control from your phone

Scan the QR to pair, pick a provider, and start steering AI sessions remotely.

Open source

Daemon, control plane, mobile app, web client. The entire stack is open and self-hostable.

What you get

A daemon that stays alive

ShellMate runs a persistent background process on your machine. It manages sessions, relays stdin/stdout between your devices, and maintains heartbeat connections to the control plane. Start it once, forget about it.

$ shellmate daemon status
running pid 4821 · uptime 3d 14h

Pick a provider, start coding

The TUI lets you browse providers, pick a profile, resume existing sessions, or start fresh. Navigate with arrow keys, hit enter, and you're streaming. Or skip the TUI entirely with shortcuts like shellmate claude.

Running sessions for Claude
 
s-7f3a running
s-2b1c running
 
+ New session

MCP servers, one command

Install Model Context Protocol servers for any supported client. ShellMate wires up the stdio transport and config files so your AI tools can interact with your machine through a standardized interface.

$ shellmate mcp install --all
claude installed
codex installed
gemini installed

Self-host everything

The entire stack is open source: daemon, control plane, CLI. Run it on your own infrastructure. Your prompts, your sessions, your data — none of it leaves your machines unless you want it to. Single-user, zero vendor dependencies.

Install globally and start in under a minute

$ npm install -g shellmate
Read the docs →