@tongil_kim/clautunnel
v1.7.0
Published
Remote monitoring and control tool for Claude Code CLI — stream terminal output, send input, and receive push notifications from your mobile device via iOS & Android
Downloads
1,863
Maintainers
Readme
ClauTunnel
ClauTunnel — Remote monitoring and control tool for Claude Code CLI from your mobile device. Stream terminal output in real-time, send input remotely, and get push notifications for task completion via iOS & Android.
Why ClauTunnel?
Running Claude Code on your workstation but need to step away? ClauTunnel lets you keep the conversation going from your phone:
- Monitor long-running tasks — Watch Claude Code terminal output in real-time from anywhere
- Send input remotely — Respond to Claude's prompts and provide input from your mobile device
- Push notifications — Get notified instantly when tasks complete, errors occur, or input is needed
- Background daemon mode — Run ClauTunnel as a background service with automatic reconnection
- Sleep prevention — Keep your Mac awake during long-running Claude Code sessions
Installation
npm (Recommended)
npm install -g @tongil_kim/clautunnelHomebrew (macOS)
brew tap TongilKim/clautunnel
brew install clautunnelSetup
Run the setup command to configure your Supabase credentials:
clautunnel setupYou'll need:
- Supabase Project ID: Dashboard → Settings → General → Project ID
- Supabase Anon Key: Dashboard → Settings → API Keys → Legacy anon Tab → Copy anon key
Usage
# Create account (first time)
clautunnel signup
# Login (returning user)
clautunnel login
# Logout
clautunnel logout
# Start a session
clautunnel start
# Start in daemon mode (background)
clautunnel start --daemon
# Prevent sleep while running (macOS)
clautunnel start --prevent-sleep
# Check status
clautunnel status
# Stop the daemon
clautunnel stopFeatures
- Real-time streaming — Terminal output streamed to your mobile device instantly
- Remote input — Send text input and commands from mobile to CLI
- Push notifications — Alerts for task completion, errors, and input prompts
- Automatic reconnection — Exponential backoff ensures reliable connections
- Sleep prevention — Keep macOS awake during long-running tasks
- Daemon mode — Run as a background service
- Multi-platform mobile — Works on both iOS and Android via Expo
Requirements
- Node.js 18+
- Claude Code CLI installed
- Supabase account (free tier works)
