TLDR
ClawTab Remote, the mobile companion app for controlling your Claude Code agents, is now available on the iOS App Store. Free download, works with both self-hosted and hosted relay setups.
What the Mobile App Does
The ClawTab mobile app gives you full remote control over your Claude Code agents running on your Mac. Here's what you can do from your phone:
| Feature | Description |
|---|---|
| Job monitoring | See all running, completed, and scheduled jobs at a glance |
| Live log streaming | Watch agent output in real time as it runs |
| Permission prompts | Answer Claude Code's yes/no permission questions remotely |
| Auto-yes mode | Enable per-pane auto-acceptance of permission prompts |
| Push notifications | Get notified when agents ask questions, finish, or fail |
| Job control | Start, stop, and restart jobs from anywhere |
| Search and sort | Filter jobs by name, group, or project |
| Workspace sharing | Let teammates monitor and respond to your agents |
The app connects to your desktop through a relay server using WebSocket over TLS. All communication is encrypted and the relay never stores your code or agent output.
Why a Native App
ClawTab Remote has always been available as a web app at remote.clawtab.cc. The native iOS app adds several things the browser can't do well:
- Push notifications via APNs - Apple Push Notification service delivers notifications reliably even when the app is closed or your phone is locked. Browser push notifications are less reliable on iOS and require keeping a tab active.
- Always-on WebSocket - the native app maintains its WebSocket connection in the background more aggressively than a browser tab, so you get faster reconnection and fewer missed updates.
- Home screen access - tap the icon and you're looking at your agents. No navigating to a URL, no browser chrome eating screen space.
- Native feel - built with React Native, the app uses native iOS components for navigation, scrolling, and gestures. It feels like an iOS app because it is one.
The web app at remote.clawtab.cc still works and will continue to be maintained. The native app is an upgrade for users who want faster, more reliable access to their agents.
Getting Started
Setup takes under a minute:
- Download ClawTab from the App Store
- Sign in with your ClawTab account
- Make sure your ClawTab desktop app is running and connected to the relay
Your devices pair automatically through the relay server. If you're using the hosted relay at remote.clawtab.cc, everything just works. If you're self-hosting the relay, point the app at your relay URL in Settings.
The app is a free download. You need a ClawTab account and either a self-hosted relay server or a ClawTab Remote subscription ($4.99/mo) for the hosted relay.
How It Works with the Desktop App
The ClawTab desktop app is the brain. It runs on your Mac, manages tmux sessions, detects Claude Code instances, and handles cron scheduling. The mobile app is the remote control.
The architecture looks like this:
- Desktop app (Tauri, Rust) polls tmux panes for agent output and detects permission prompts
- Relay server (Rust, Axum) routes messages between desktop and mobile over WebSocket/TLS
- Mobile app (React Native, iOS) displays job state and sends commands back through the relay
When Claude Code asks a permission question, the desktop detects it in the terminal buffer, parses the numbered options, and sends a notification through the relay. Your phone receives the notification and displays it as a tappable card with option buttons. Tap an option, and the keystroke goes back through the relay to the desktop, which types it into the tmux pane.
The round trip is typically under 100ms. From the agent's perspective, it's as if you typed the answer at your keyboard.
Comparison: Native App vs Web App vs Telegram
ClawTab offers three ways to control your agents remotely. Here's how they compare:
| iOS App | Web App | Telegram | |
|---|---|---|---|
| Push notifications | APNs (reliable) | Web Push (less reliable on iOS) | Telegram notifications |
| Live log streaming | Yes | Yes | No |
| Answer questions | Yes | Yes | Yes |
| Auto-yes | Yes | Yes | No |
| Job management | Full | Full | Limited |
| Background connection | Good | Limited | N/A |
| Requires install | Yes | No | Yes (Telegram) |
The iOS app is the best experience. The web app is the most accessible. Telegram is useful for notifications if you already live in Telegram.
Screenshots
What's Next
The App Store release is the starting point. We're working on:
- Android - the React Native codebase supports Android. An Android release is planned.
- Widgets - iOS home screen widgets showing active agent count and status.
- Shortcuts integration - trigger ClawTab actions from Siri and the Shortcuts app.
- Watch app - quick glance at agent status and one-tap approval from your wrist.
The app is open source. Feature requests and contributions are welcome.
