@cgaravitoq/aiusage

Report local token usage to an aiusage instance.

The collector requires Bun 1.4.0 or newer, which ships node:sqlite, and supports macOS and Linux. Windows is unsupported, and npm refuses the install there.

Install

bun add -g @cgaravitoq/aiusage
aiusage install --url <url> --key <key>

install writes ~/.config/aiusage/config.json with mode 600 and a launchd agent on macOS or a systemd user timer on Linux that runs aiusage collect every fifteen minutes. Pass --timezone <zone> to override the machine's IANA timezone, or --dry-run to print the files without writing them. Non-dry install refuses Bun paths containing /install/cache/ or a bunx-<digits>-<package> directory segment, because those paths can disappear while a schedule still points to them.

Running install with a new url adds a target and keeps the existing ones, and running it again with a configured url replaces that target's key, so one machine can feed a personal instance and a team board at once. The config is { "targets": [{ "url": "...", "key": "..." }], "timezone": "..." }, and the single-target shape written before targets existed still reads.

Report

aiusage collect reports the last 14 calendar days to POST /api/report of every configured target. The rows come from ccusage for every agent it detects except Antigravity, plus two sources the collector decodes itself: the Antigravity CLI conversations under ~/.gemini/antigravity-cli/conversations, reported as antigravity in place of ccusage's Antigravity rows because ccusage's adapter leaves the reasoning tokens out of output and names the model with its effort suffix, and the Devin CLI transcripts, which ccusage has no adapter for, under ~/.local/share/devin/cli/transcripts, reported as devin with the effort suffix of each model collapsed into its LiteLLM name. Both are priced from the LiteLLM table cached for a day at ~/.config/aiusage/litellm-prices.json.

collect prints one accepted <n> days for <machine> at <url> line per target, where <n> is the number of usage rows the instance stored rather than a count of calendar days, and exits 1 when any target rejects the report.

Upgrade

bun add -g @cgaravitoq/aiusage@latest
aiusage install --url <url> --key <existing-key>

On macOS, run launchctl bootout gui/<uid>/dev.aiusage.collector, then run the printed launchctl bootstrap command. On Linux, run systemctl --user daemon-reload, then run the printed systemctl --user enable --now aiusage.timer command.