claude-hud

Drive Claude Code sessions from Even Realities G2 smart glasses over your local network. One command on your PC spawns a broker, registers the current working directory, and runs claude inside a PTY so the glasses can attach — voice in, glasses out, no cloud relay.

See the project repo for architecture, the broker design, and the companion Even Hub plugin (.ehpk) that runs on your Android phone.

Requirements

• Node 22 LTS or newer (node --version ≥ 22)
• Claude Code installed and authenticated (claude --version)
• A C/C++ toolchain — node-pty builds from source on install (python3, make, a working C++ compiler)
• For the glasses half: Even Realities G2 + the Even Realities app on Android with the companion .ehpk plugin sideloaded

Installation

npm install -g @xerktech/claude-hud

That puts the claude-hud binary on your $PATH. The package is published to the public npm registry with provenance — you can verify the source commit it was built from on the npm page.

Usage

claude-hud                    # ensure broker + register cwd + run claude
claude-hud pair               # re-print the broker's pairing QR
claude-hud broker status      # is the broker up? sessions? paired?
claude-hud broker logs        # tail the detached broker log
claude-hud broker stop        # terminate the detached broker
claude-hud --help             # full usage

Anything after claude-hud that isn't a subcommand is forwarded to claude verbatim — including --resume <id>, model selectors, and the like.

First run prints a QR code; scan it from the companion plugin on your phone to pair the glasses with the broker. Tokens, settings, and the generated TLS cert live under ~/.claude-hud/ (override with CLAUDE_HUD_DIR).

How it fits together

+--- Glasses (G2) ---+  BLE  +--- Android phone ---+  HTTPS/WS  +--- This CLI ---+
| 576×288 greyscale  | <---> | Even App + plugin   | <--------> | broker + PTY   |
| Touchbars, mics    |       | (.ehpk we publish)  |   LAN      | spawns claude  |
+--------------------+       +---------------------+            +----------------+

Voice tokens, transcripts, and approvals flow only over your private Tailscale (WireGuard) overlay — no public-Internet exposure, no Cloudflare Tunnel, no telemetry. (Local dev/CI/simulator can drop to a LAN bind with BROKER_DEV_NO_TAILSCALE=1.)

License

MIT — see LICENSE.