quartermaster an instrument by

Find out before you hit the wall.

The ones out there read one credential: the default directory's. This one reads every profile you have, plus Codex and opencode — no network, no credentials.

Built by Valentín Torassa and Sol Soletti

$brew install legiosai/tap/quartermaster

Homebrew. Also on npm.

The other ways to install it The code, on GitHub ›

The GNOME top bar with three meters: one account at 32 %, another at 27 % and another at 50 %.

The quartermaster panel: the “what stops you first” ring at 100 %, and one card per account with its bars, the last few hours as a curve, and when it resets.

One meter per account up top. The full panel one click away.

01 The problem

Monitors read one credential. You have three accounts.

Claude Code supports several profiles through CLAUDE_CONFIG_DIR, and each one has its own account and its own credential. A work seat and a personal subscription on the same laptop is ordinary. What exists reads one: the default directory's — which tends to be exactly the empty one.

Every profile

It finds every CLAUDE_CONFIG_DIR on the machine, not just ~/.claude. Plus Codex and the providers opencode stores.

No credentials

It does not open your keychain or read a token. The number comes from cachedUsageUtilization, where Claude Code leaves the server's last answer.

And it warns you

At 80% and 95%, when the projection says you hit the wall before the reset, and — most usefully — when you are free again.

02 The evidence

The finding that justifies it

Inside limits[] there are bars with no named key of their own. Reading only the two famous ones showed a comfortable account. The one actually about to stop it was 67 points higher, flagged by the server.

five_hour — what the others read8 %

seven_day — what the others read59 %

weekly_scoped — the one that stops you75 %

67 points of difference, and it looks calm

That bar was marked warning by the server itself and showed up in no monitor, because it has no named key: it lives inside the list. quartermaster shows whichever one stops you first.

03 The surfaces

Where you are already looking

The same number, drawn for each desktop. There is no app to open.

GNOME

One meter per account in the top bar, and the panel on one click with its own extension.

make indicador

macOS

The menu bar, with the same panel and the same meter.

make barra

Windows

The notification area, with a ring that says how much is left. Native, or from WSL.

make tray

The terminal

A table, or one line for your statusline. And --json for scripts.

qm --breve

The GNOME top bar with three vertical meters and their numbers. — **GNOME** · one meter per account, top right

The Windows tray with one icon per product: opencode, codex and Claude with its meter. — **Windows** · one icon per product in the tray

The panel on GNOME, dark theme: the ring of what stops you first and one card per account. — **GNOME** · dark theme

The same panel on Windows, light theme, with the main account at 100 % of its weekly bar. — **Windows** · light theme

$ qm --breve
main 46/89%! · teams 36/60%! · codex 50/100%!
# session/week per account. "!" is a bar the server flagged with a warning.

04 Install

Getting it running

There is no build step: qm reads its TypeScript directly, which is why it asks for Node ≥ 22.6.

$ brew install legiosai/tap/quartermaster
$ qm

$ npm install -g @legios/quartermaster
$ qm

# once: the key and the repo
$ sudo install -d -m 0755 /etc/apt/keyrings
$ curl -fsSL https://quartermaster.legios.com.ar/apt/legios.gpg \
    | sudo tee /etc/apt/keyrings/legios.asc >/dev/null
$ echo "deb [signed-by=/etc/apt/keyrings/legios.asc] \
    https://quartermaster.legios.com.ar/apt stable main" \
    | sudo tee /etc/apt/sources.list.d/legios.list >/dev/null

# and from then on, like any other package
$ sudo apt update && sudo apt install quartermaster

# the installer from the latest release: puts qm on your
# PATH and the tray in the Start menu. Per-user, no UAC.
> quartermaster-0.1.20-setup.exe
> qm

# (winget and scoop: the manifests are written and not
#  approved yet. npm works in the meantime.)
> npm install -g @legios/quartermaster

$ git clone https://github.com/legiosai/quartermaster
$ cd quartermaster && npm install
$ make instalar   # puts `qm` in ~/.local/bin

The apt repo is signed and lives on this same page, so apt upgrade brings the new version by itself. The launcher looks for a usable Node on the PATH and in nvm; if it finds none, it says so and explains how to get one.