github my-claude-utils/clsh v0.1.0
v0.1.0 — Your Mac, in your pocket

latest releases: v0.1.9, v0.1.8
21 days ago

What's in v0.1.0

The first tagged release of clsh. Everything you need for phone-first terminal access to your Mac.

Terminal

  • Multiple live PTY sessions (up to 8 concurrent)
  • Session persistence via tmux control mode (sessions survive server restarts)
  • Claude Code streaming from your phone
  • Session grid with live terminal previews

Keyboard

  • Two layouts: iOS Terminal (6-row) and MacBook (5-row)
  • Sticky modifiers, key repeat, context strip
  • 6 keyboard skins with Skin Studio

Connectivity

  • 3-tier tunnel: ngrok (static URL) → SSH (localhost.run) → local Wi-Fi
  • Zero-config start with SSH tunnel (no signup needed)
  • Permanent URL support with ngrok static domain
  • Lid-close networking: tunnel auto-recovery, wake detection, Wi-Fi keep-alive docs

Mobile

  • PWA: install to home screen, fullscreen, no browser chrome
  • Custom keyboard replaces iOS system keyboard
  • Safe-area insets for Dynamic Island and notch devices
  • Demo mode when no backend is reachable

Auth

  • One-time bootstrap token + QR code
  • JWT sessions (30-day expiry)

Infrastructure

  • Turborepo monorepo (agent + web + cli + landing)
  • CI: lint + typecheck + build on Node 20 + 22
  • Landing page on Cloudflare Pages (clsh.dev)

Don't miss a new clsh release

NewReleases is sending notifications on new releases.