ai-tether
v0.5.2
Published
Monitor and control your Claude Code sessions from your phone or browser — end-to-end encrypted, open source.
Downloads
418
Maintainers
Readme
AI Tether
Monitor and control your Claude Code sessions from your phone or any browser — end-to-end encrypted, open source.
AI Tether is a small daemon that runs on your Mac and mirrors your Claude Code sessions to a phone app or a browser, so you can watch live transcripts, approve tool permissions, send follow-up prompts, and launch or stop runs while you're away from your desk. It's the same idea as Anthropic's own /remote-control, but end-to-end encrypted and self-hostable.
What it actually does (so you can decide if you want it)
Yes — this is remote-control software, on purpose. Here's exactly what installing it does:
- Runs a local daemon (
tether) that hooks into Claude Code's public extension points (lifecycle hooks, transcripts, the Agent SDK) to track your sessions. - Connects outbound to a relay (the free hosted one at
relay.ai-tether.com, or your own) which forwards traffic between your Mac and your phone/browser. - The relay only ever sees ciphertext. Your Mac and your device agree on an encryption key during pairing (NaCl box: Curve25519 + XSalsa20-Poly1305); the key is bootstrapped through a pairing QR/code and never touches the relay. Your transcripts, prompts, and code are never in plaintext on any server — ours or yours.
That's the whole trust story: powerful, but encrypted end-to-end, open-source, and reviewable. This package is intentionally shipped un-minified — read cli.js before you run it if you like.
Install
npm install -g ai-tether
tether starttether start registers with the relay, installs the Claude Code hooks + a login service, and prints a pairing QR. Scan it with the AI Tether app, or open app.ai-tether.com and paste the pairing line. Then start a Claude Code session and watch it appear.
Requires Node.js 20+.
Uninstall
tether service uninstall # stop the background service
tether hooks uninstall # remove the Claude Code hooks
npm uninstall -g ai-tetherLinks
- Home: https://ai-tether.com
- Self-host the relay:
tether start --relay wss://your-host
Not affiliated with Anthropic. “Claude” and “Claude Code” are trademarks of Anthropic, PBC.
