Claude Code mascot

claude-widgets

iPhone home-screen widgets for Claude Code usage. Zero extra tokens. Your Mac, your Tailnet, your data.

Small · hottest rate-limit as hero
Medium · both rate limits at a glance
Large · live sessions + 7-day history

One script, every size. Pick any family in Scriptable — the widget detects and renders. Add as many as you want.

Install — three steps

All three are required. The first two are probably already on your devices.

  1. 1. Tailscale on both devices

    Free tier is fine. iPhone and Mac need to be on the same tailnet so the phone can reach the Mac — no public ports, no cloud hop.

    Download Tailscale · sign in on both devices with the same account.

  2. 2. Scriptable on iPhone

    Free App Store app. This is what runs the widget code.

    Scriptable on the App Store.

  3. 3. Run the installer on your Mac, scan the QR

    It wires the Claude Code statusline hook that collects your usage, starts a tiny HTTP server bound to your Tailscale IP, and prints a QR code in the terminal.

    curl -fsSL https://claude.egor.lol/install.sh | bash

    Scan the QR from the iPhone camera → tap Install in Scriptable → tap Save. You're done.

    Long-press home screen → + → Scriptable → pick Small / Medium / Large → select Claude Code. Same script powers every size; add more than one widget if you like.

Also needed:

Why