Omarchy AI Usage

Omarchy AI Usage puts the AI coding quotas from your Linux desktop on your watch.

Four gauges, one on each side of the watch face, each tracking a limit you
choose: a Claude Code session window, a weekly Grok allowance, an Antigravity
thinking quota, today's total token burn. Glance at your wrist instead of
alt-tabbing to a terminal.

HOW IT WORKS

This app is one half of a pair. The other half is the Omarchy AI Watch Bridge,
a small open-source program you run on your own Linux machine. It reads the
usage figures your AI coding tools already write to disk and serves them on your
local network. Your watch reads them from there, over your own Wi-Fi. Nothing
goes to a server, because there isn't one.

Both halves are MIT licensed and on GitHub. You need the desktop bridge
installed and running for this app to show anything.

WHAT YOU GET

• Dashboard — every tracked quota, today's tokens and sessions, and an honest
account of whether the figures are current or stale.
• Four configurable gauges — tap any side of the face to point it at any limit
your machine reports.
• Five complication data sources — top, right, bottom, left, plus a Smart one
that automatically follows whichever quota is closest to running out. They
work on any watch face, not just ours.
• Quota alerts — an optional buzz when a tracked quota rolls over to a new
window or hits 100%. Per gauge, with a test button so you can confirm it
reaches your wrist.
• Setup with nothing typed on the watch — tap Connect, then approve on your
laptop. The watch finds your machine on its own.
• It heals itself — when your router hands your laptop a new address, the watch
finds it again without asking you to reconnect.

WORKS WITH

Any AI tool that reports usage to Omarchy's agent directory. Currently that
includes Claude Code, Antigravity, Grok, Codex, Gemini, OpenCode, Fireworks,
Ollama and DeepSeek. Providers are discovered dynamically, so a new one shows up
without an app update.

REQUIREMENTS

• Wear OS 3 or later (this app); Wear OS 5 or later for the matching watch face.
• A Linux machine running the Omarchy AI Watch Bridge.
• Both on the same Wi-Fi network.

PRIVACY

No accounts, no analytics, no advertising, no data collection of any kind. The
app talks only to the bridge on your own network. Full policy:
https://gladimdim.github.io/omarchy-ai-companion/privacy.html

The matching watch face, "Omarchy AI Usage", is a separate free download.