Access your terminal and your AI agent from any device — phone, tablet, desktop.
# Add to your Claude Code skills
git clone https://github.com/my-claude-utils/clshYour Mac, in your pocket.
Real terminal access from your phone. Not SSH. Not a simulation. A real PTY on your machine, streamed to your pocket.
Live Demo · Getting Started · How It Works · Contributing
<br /> <img src="assets/setup-flow.gif" alt="clsh setup flow" width="300" /> </div>clsh gives you real terminal access to your Mac from your phone. One command, scan the QR code, and you're in. Multiple live terminal sessions, a custom keyboard built for terminal use, 6 keyboard skins, and session management. Open source, zero config.
No comments yet. Be the first to share your thoughts!
Key highlights:
Requires Node.js 20+ and macOS or Linux.
npx clsh-dev
A QR code prints to the console. Scan it on your phone. That's it.
For a static URL that survives restarts (perfect for PWA home screen):
npx clsh-dev setup
See the ngrok setup guide for details.
Phone / Tablet / Browser
│
│ HTTPS (WebSocket)
▼
┌──────────────┐
│ Tunnel │ ngrok (static URL) / SSH (localhost.run) / Wi-Fi
└──────┬───────┘
▼
┌──────────────────────┐
│ clsh agent │ ← runs on your machine
│ ├── PTY 0: zsh │
│ ├── PTY 1: claude │
│ ├── PTY 2: ... │
│ └── up to 8 sessions │
└──────────────────────┘
npx clsh-dev starts the backend agent + React fronten...