How I Built clsh: Phone-First Terminal Access to Your Mac

The author built clsh, an open-source tool providing real terminal access to a Mac from a phone, primarily to monitor long-running AI coding agent sessions like Claude Code. It uses node-pty for true PTY sessions with WebSocket connections, a 3-tier tunnel system (ngrok, SSH via localhost.run, local WiFi), JWT authentication, and optional tmux wrapping for session persistence.