Skip to content
RunicGet Runic

macOS menu bar · open source · v2.13.5

Every window
opens again.

Runic reads the quotas, credits, pace and reset windows of the AI tools you pay for, and keeps them in one quiet corner of your Mac.

Get Runic See the 35 providers
  • Session · 5-hour window62% usedresets in 2h
  • Weekly · 7-day window41% usedresets in 99h
  • Monthly · 30-day window18% usedresets in 590h

Illustrative windows, not account data · hover the dial to fast-forward

Latest2.13.5
Runs onmacOS 14 or later
Reads35 providers
Looks13 themes · 7 skins
LicenceMPL-2.0
Checked against9730f91 ↗

01 Read the whole window

A percentage without time is half an answer. Runic keeps the limit, the pace and the next reset side by side, so you can decide to keep going, switch tools, or take the break the window was about to give you anyway.

The Runic menu open on Codex: session and weekly windows, each with its reset time and pace
The menu, open on Codex
Providers, read the way each one allows
35
Themes
13
Skins that recompose every page
7
Runic accounts to create
0

02 Coverage

35 providers, read the way each one allows.

Some plans have windows, some keys have a balance, and some platforms expose no quota at all. Runic shows what each one actually reports, and nothing it doesn’t.

Subscription tools 9

Plans with windows that fill and reset.

Keys and balances 12

API keys, read for balances, credits and plan quotas.

Clouds and model platforms 14

No quota to read. Runic shows what the account can reach.

From the provider notes at 9730f91. China-region accounts (Kimi, z.ai, MiniMax, Qwen, StepFun, SiliconFlow) are separate slots of the same provider. The full coverage guide →

03 One reading, three surfaces

The interface changes. The reading doesn’t.

  1. 01 / macOS

    The quiet glance.

    A native menu bar app. Quotas, credits and the next reset, where you already look.

    How the panel is drawn →
    The Runic menu panel open on Claude
  2. 02 / Terminal

    The direct reading.

    The same numbers in a shell, a script or CI, as text or JSON.

    The CLI guide →
    $ runic --provider claude
Claude Code 2.0.58 (web)
Session: 88% left
Resets tomorrow at 1:00 AM
Weekly: 63% left
Resets Sat at 6:00 AM
Sonnet: 95% left
    Sample output from the CLI docs
  3. 03 / MCP

    The shared context.

    A local, read-only server, so an assistant can check capacity before it promises more work.

    The MCP guide →
    "runic": {
  "command": "/Applications/Runic.app/Contents/Helpers/RunicCLI",
  "args": ["mcp", "serve"]
}
runic_limits  quota windows, resets, credits
runic_health  last refresh, data age, sources
    Client config and the two built-in tools

04 Different material, same instrument

Seven ways to draw the same number.

13 themes, drawn by 7 skins. A theme changes the colours; a skin recomposes every page of the panel. Shown with the app’s demo data.

The Runic panel drawn by the Gazette skin, with demo data

Gazette

A printed broadsheet: masthead, lead story, columns, pull quote, dotted leaders.

Faces
Fraunces · Manrope
Render
The app’s own view, demo data

05 A local instrument

Close to the source. Clear about the boundary.

No product analytics, no telemetry, no crash reporting. Network access is limited to what the enabled features need.

  1. 01 / On your Mac

    Settings and local state.

    Runic does not need an account of its own. Credentials follow the mechanism each provider documents, and the usage history is kept on this Mac.

  2. 02 / At the provider

    The reading comes from somewhere.

    Provider interfaces can require network requests. The provider notes say where every number comes from and what leaves the machine to get it.

  3. 03 / When a source fails

    Uncertainty stays visible.

    Unavailable and stale data stay distinct from a fresh reading. A blank is more useful than invented confidence.

06 Runic 2.13.5

Install it your way.

For macOS 14 or later.

  1. 01

    Homebrew

    The native app, kept up to date by the cask.

    brew install --cask sriinnu/tap/runic
  2. 02

    GitHub release

    Download the signed build and read the change notes.

    Open the latest release ↗
  3. 03

    From source

    Clone it, read it, build it yourself.

    git clone https://github.com/sriinnu/Runic.git
    Build instructions

07 Field notes

The working knowledge.

8 guides from the wiki and 58 reference notes from the repository, checked against the same commit.

  1. 01Architecture
  2. 02Runic CLI
  3. 03Claude
  4. 04Contributing
  5. 05Runic MCP
  6. 06Providers
  7. 07Release and ops
  8. 08Themes and skins
Repository reference 58 notes

Every window opens again.

Get Runic