Bubbles

Your Claude Code sessions, on your wrist.

See which sessions need you, read a summary, dictate a reply by voice, and tap through menus — from your watch. bubble-wand is the free, self-hosted bridge that makes it work. Your Anthropic key and your code never leave your machine.

Install the bridge Integration guide View on GitHub ↗
$ curl -fsSL https://get.darn-tech.com/install.sh | bash
or clone it yourself — git clone https://github.com/GreenTilden/bubble-wand && cd bubble-wand && ./install.sh

How it works

A “thread” on your wrist is a tmux pane running claude on your box. The bridge reads and writes those panes directly — so it runs on the same machine as your sessions. That constraint is the privacy model: no server in the middle, no shared host, no one else ever holds your key.

Wear OS watch ──HTTP (+ bearer token)──▶ bubble-wand ──tmux──▶ your Claude Code panes (Bubbles app) (on YOUR box) (session "dev", window 1)

Why you can trust it on your box

🔒

Your key stays local

Written to a 0600 file by the LAN-only setup page and sent only to Anthropic, on your behalf. No telemetry, ever.

🛡️

Injection-safe tmux

Every tmux call uses an argv list — no shell. Dictated text is sent literally, so control sequences in your voice reply are typed, never executed.

📡

LAN-first, tunnel-optional

Runs on your home network out of the box. Reach it from anywhere by fronting it with a Cloudflare Tunnel — your call, not a default.

🔑

Bearer-token on everything

Every API route needs your token (constant-time compare). Onboarding refuses any proxy or tunnel hop — you provision on the LAN, then expose it if you want.

Set it up in about a minute

  1. Run the installer on the box where your Claude Code tmux sessions live. It sets up a small service and prints a one-time setup URL.
  2. Open that URL from your phone on the same wifi, paste your Anthropic key, and hit Provision. It mints a token — nothing is typed into a file by hand.
  3. Enter the shown URL + token in the Bubbles watch app’s Settings, and pair.
  4. Turn your wrist. Your sessions are there. 🫧

Requirements:

Python 3.11+ tmux (your claude panes) an always-on box your own Anthropic API key

Want the full walkthrough — mapping sessions, config, remote access, the API? Read the integration guide →

The watch app

⌚

Bubbles for Wear OS PILOT

The client half — lists your threads, live status, reads the tail, takes voice replies. In invite-only testing now; a public Play Store listing is on the way.