pocketshell

About

pocketshell exists for the moment a long-running coding agent needs attention while the developer is away from the desk: it turns a phone browser into a resilient terminal onto the dev machine's tmux sessions, where agents like Claude Code, Codex, opencode, or Kimi CLI run alongside plain shell, vim, and htop. Sessions persist server-side, so a dropped connection loses nothing — on reconnect the terminal replays exactly the missing gap of output — and push notifications arrive even with the phone locked when an agent finishes or blocks on input. Setup is a single Bun-built binary plus a pairing string with a 300-second TTL; optional integration writes hook/notify entries into each agent's config (Claude Code settings, etc.) for finish-and-notify events, and delivery spans Web Push and webhooks to WeCom, Feishu, Slack, and Discord. Security got attention the hard way: a web admin page was removed in v1.8.0 over an anonymous-access vulnerability, with audit guidance for older deployments. Self-hosting developers who want phone-based agent supervision without a cloud relay are the audience.