Dashboards and bar widgets for tracking AI coding-agent usage on Omarchy.
- Web dashboard (
apps/web) — a local-first Bun + Hono + React + SQLite console with provider standings, trends, redacted transcript search, and a citation-bound local analyst. Its Cloudflare Access–gated limits portal now has four operational tabs: limits (with depletion forecasting and a lockout-alert inbox), descriptive token/productivity comparisons, cached GitHub/Linear source synchronization, and activity detail for inspecting public commits and completed tasks. The Analyst page also provides local prompt analysis: it scores task complexity, explains required capabilities, and compares model/provider cost, latency, confidence, and fallback fit without changing configuration. Remotely reachable through Cloudflare Tunnel with Access-gated authentication — see it running at agents.harlanljones.com. - Agent leaderboard (
apps/omarchy-agent-leaderboard) — Omarchy bar widget ranking token usage across every coding agent on the machine. Forked frommustafaokur.agent-leaderboard(MIT). - Agent usage (
apps/omarchy-agent-usage) — fork of Omarchy's first-party Agents widget focused on per-provider usage and limits. - Provider assets (
packages/provider-assets) — single source for provider marks; each app consumes them through a repository-relative symlink, and plugin builds dereference the link so deployed plugin directories stay self-contained.
Web dashboard — standings, coverage, and the local analyst |
Agents usage panel — limits, daily tokens, and models |
Agent Leaderboard bar widget |
Prompt analysis — complexity, model fit, cost, and latency |
Prompt analysis — expanded evidence and uncertainty |
|
Activity detail — inspect public commits and completed tasks |
Source sync — freshness, coverage, and cached record state |
Activity detail — responsive mobile view |
bun install
bun run check # test + typecheck + build across the workspace
bun run dev --filter=@omarchy-agents/webThe dashboard serves http://127.0.0.1:4317. It indexes local Claude, Codex, Cline, Antigravity, OpenCode, Fireworks, and usage-collector stores; secret-like content is redacted before anything is persisted.
On the Analyst page, paste a prompt or enter an indexed session ID to run the prompt analyzer. It reports low/medium/high complexity across context, reasoning, tool use, code scope, reliability, and latency; recommendations are advisory and only use known pricing. Unknown model pricing, missing context, and conflicting requirements are shown explicitly.
To install the bar widgets locally:
bun run deploy:local # builds plugins into ~/.config/omarchy/plugins/apps/web/deploy/executable_provision-cloudflare.sh provisions a remotely managed Cloudflare Tunnel, DNS route, OTP identity provider, and a single self-hosted Access application (one allow policy for your email plus the Worker service policy) covering the tunnel hostname — page, assets, and API share one session, and the limits portal additionally enforces an admin audience at the origin. The tunnel hostname (API_HOSTNAME) serves the Worker's service-token proxy; the browser-facing hostname (DASHBOARD_HOSTNAME) is where people browse, and the Worker redirects /limits* to the portal on the tunnel host. See apps/web/README.md for the required environment variables.
Loopback traffic stays unauthenticated; remote requests require a valid Cloudflare Access JWT scoped to your team, audience, and allow-listed email.
Chezmoi owns the systemd units, untracked environment files, Omarchy/Cline settings, usage collector overrides, and the after-apply hook that invokes this workspace. Secrets never live in this repository — see docs/chezmoi-boundary.md.
MIT. The leaderboard app carries its upstream notices in apps/omarchy-agent-leaderboard/LICENSE.