Tokenrunway v0.2.0

What's new

Added

• OpenRouter: add an OpenRouter API key to see its spend limit or budget with the reset, what
  it has spent today, this week and this month, and free-model requests on the free tier. A
  management key also shows your account's credit balance.
• A tokenrunway command: tokenrunway status lists every account's windows, resets and
  forecasts with today's spend; tokenrunway statusline prints one short line for your shell
  prompt or Claude Code's status line; tokenrunway today breaks today's spend down by harness,
  model and project. Add --json for scripts. Homebrew puts it on your PATH.
• Spend goals: set a daily and a monthly goal (API-equivalent) in Settings → Spend goals. The
  Now tab shows a ring for each, you're notified at 80% and 100%, and with the $ today label the
  menubar icon turns amber, then red, as you get close.
• Fast-session warnings: when a session spends 3× your usual pace (at least $5 in 20 minutes),
  you get a notification and a banner on the Now tab, so a runaway agent loop doesn't eat your
  window.
• Switch to save: when a window is tight, Tokenrunway says where there's room, like "Weekly
  Opus is at 83% but Weekly is only at 64%: switch to Sonnet" or "ChatGPT has room (Codex weekly
  at 12%)". It's on the Now tab and in the run-out notification.
• In-app toasts: alerts also pop up inside Tokenrunway while it's open. Settings →
  Notifications → Send a test shows one.
• Pin a window to the menubar: Settings → Menubar label → Window picks which window the
  % left or Runway label follows, instead of the most urgent one.
• Copy usage summary: the copy button on the Now tab puts a short text summary of every
  account on the clipboard, ready to paste into Slack.
• LM Studio: requests to LM Studio's local server now show up in Stats, Harness and the
  dashboard, with each model's input, output and reused (cached) tokens. They're local, so they
  read as Free and never count towards your spend. Models running on the MLX engine don't log
  token counts, so they aren't included yet.
• Projects and branches: the dashboard lists what each project cost, its sessions, cache hit
  rate and top git branches. Click one to see all its branches, with the charts and sessions
  narrowed to it.
• Open the dashboard from Stats: click a model or project under Top models / Top projects to
  see it in the dashboard.
• Cache tips: when a project's prompt cache works far worse than your usual, Insights says so
  and what the logs show about why: long pauses, switching models mid-session, or short sessions.
• Weekly recap: on Mondays, a notification with last week's spend, the change from the week
  before, your top project and biggest session. The dashboard has it as a card. Turn it off in
  Settings → Notifications.
• Plan value: what your Claude, ChatGPT or Gemini subscription did this month at API prices,
  like "Your $200 Max 20x plan did $3,199 of API-equivalent work this month (16×)". For Team,
  Enterprise and Business seats, add the price under the account in Settings.

Changed

• Stats has a Local models section listing your LM Studio models by tokens, since they're free
  and would never make Top models.
• Session lengths count working time only: a pause of more than 30 minutes isn't part of the
  session, so a session you come back to days later no longer reads as days long.
• The % left menubar label now shows what's left (it showed what was used).
• Clicking the menubar icon opens Tokenrunway on the tab you left it on (Now, Stats or Harness),
  even after a restart.
• Stats → Today no longer shows a daily spend chart with a single bar.

Download the installer for your platform below.

macOS 11+ (Apple Silicon and Intel): open the .dmg and drag Tokenrunway to Applications. Or install with Homebrew: brew install --cask slastrina/tap/tokenrunway
Windows: run the -setup.exe (or the .msi). If SmartScreen warns you, choose More info → Run anyway.
Linux (x86_64): install the _amd64.deb (Debian, Ubuntu 22.04+) or run the _amd64.AppImage (chmod +x first). The tray needs libayatana-appindicator (and on GNOME the AppIndicator extension); logins need a Secret Service keyring such as GNOME Keyring or KWallet.
Linux (arm64): the _arm64.deb or the _aarch64.AppImage.