Repository navigation
Releases
Releases · Abulkosim/margin
Margin v0.11.0
v0.11.0
2026-11-10 · Download
- Margin now ships its own copy of the Inter font, so text looks the same on every Mac and PC, as in the screenshots.
- The keyboard focus ring is easier to see in light mode.
- Messages at the bottom of the window stay while you hover over or focus them, so there's time to press Undo, and screen readers announce them.
- Pressing Esc in Add account closes only the form and keeps what you typed.
- Clearer wording: "Reset alerts" and "Not updating alerts" in Settings, reset tooltips without seconds, and the same wording for errors throughout.
- With History closed, cards reload usage history about once an hour instead of on every refresh, so Margin does less work with many accounts.
- If a provider changes the letter case of your email, Margin keeps that account's usage history.
- Margin keeps only the five newest settings backups.
- Updated dependencies and a smaller app.
- This release passed automated tests and builds on macOS and Windows but hasn't been checked by hand on a real Mac or Windows PC yet. If something looks wrong, use Report a problem.
Margin v0.10.2
v0.10.2
2026-11-10 · Download
- Start at login keeps working after you move Margin. On macOS it follows the app once it runs from Applications; on Windows it follows the app when the old copy is gone.
- An alert or weekly digest that couldn't be shown before you quit Margin is shown after you reopen it, if it still applies. One that was already shown isn't repeated.
- A Claude model limit that the server sometimes sends malformed no longer repeats the same usage alert.
- An out-of-range reset time or limit length from a provider no longer breaks the popover for every account. Only that reading fails or loses that limit, and other accounts keep updating.
- If a session or weekly limit arrives without a percentage, the reading is marked Incomplete instead of looking complete.
- This release passed automated tests and builds on macOS and Windows but hasn't been checked by hand on a real Mac or Windows PC yet. If something looks wrong, use Report a problem.
Margin v0.10.1
v0.10.1
2026-11-06 · Download
- Updated dependencies to their latest compatible versions, including wry 0.57.1, tao 0.37.2, the bundled root certificates and Vite 8.3.6. No features change.
- This release passed automated tests and builds on macOS and Windows but hasn't been checked by hand on a real Mac or Windows PC yet. If something looks wrong, use Report a problem.
Margin v0.10.0
v0.10.0
2026-11-05 · Download
- Idle accounts: when a Claude Code token expires while you aren't using it, the account now says "Idle, last read 3h ago" instead of "Signed out", with the command that gets a new reading. Real sign-outs still say "Signed out".
- After a limit's reset time passes with no new reading, it shows "Reset 14:00, not read since" instead of the old percentage.
- If part of a provider's response can't be read, the limits that could be read stay visible, marked "Incomplete".
- Settings → Notifications has Send test notification. Margin retries a notification it couldn't submit and shows the failure there.
- The "Usage not updating" alert now also fires when an account's usage server can't be reached while your other provider reads fine.
- Margin offers Start at login once, so alerts keep running after a restart. On macOS it warns when the app isn't in Applications. "Launch at login" is now "Start at login".
- Report a problem in Settings opens a prefilled GitHub issue after you review it. It includes the version, OS, account counts and error kinds, and leaves out emails, account names, paths and tokens.
- Make active is labeled Beta until it has had more real-world testing.
- This release passed automated tests and builds on macOS and Windows but hasn't been checked by hand on a real Mac or Windows PC yet. If something looks wrong, use Report a problem.
Margin v0.9.0
v0.9.0
2026-11-02 · Download
- Run-out warnings: a notification when a session, weekly or model limit is on pace to run out before it resets, with the time it runs out. On by default; Settings → Notifications.
- Usage not updating: a notification when an account can't be read for 30 minutes, so you know its alerts can't fire. On by default.
- An 80% or 95% alert also says when the limit runs out, if that's before it resets.
- The card's pace line uses the same forecast as the warnings, and weekly pace reads the last day and a half, including time away from the computer.
- Margin writes its settings file far less often while refreshing.
- A new sign-in in the same folder no longer adds readings to the previous person's history, and removing an account keeps its history if saving settings fails.
- History keeps saving after going back to v0.7 and forward again with Codex accounts.
- On macOS, Make active refuses a sign-in too long to pass safely to the Keychain instead of putting it on the command line.
Margin v0.8.2
v0.8.2
2026-11-02 · Download
- An account no longer shows as last known, or drops out of the tray's lowest-remaining pick, when only a model limit such as Opus has passed its reset time.
- Reset and fast usage alerts cover Codex plans whose limits are not 5 hours or 7 days, such as monthly limits.
- Changing plan no longer sends usage alerts you already got again.
- Usage history stays continuous when a provider reports the same reset time a few seconds apart, so history files stay small.
- After a sign-in changes during a refresh, Margin retries within seconds instead of waiting a full interval.
- On macOS, a Keychain item without a Claude sign-in falls back to
.credentials.json. - Make active is safer: restoring a backup refuses while Codex runs, a relaunch no longer makes a restore overwrite a newer sign-in, locks left by a crash are reclaimed, and an unreadable switch history is kept aside instead of overwritten.
marginwith a mistyped option such as--jsnoprints the usage instead of starting the app.
Margin v0.8.1
v0.8.1
2026-10-27 · Download
- Notifications, the tray tooltip and
margin --line --shortfollow your system's 12- or 24-hour clock, like the popover. - Make active names accounts by label and plan when two accounts share an email, for example "Claude Team (Team)" and "Personal (Max 20×)".
- The Add account hint tells you how to sign in first: on macOS
CLAUDE_CONFIG_DIR=<folder> claude, since the sign-in lives in the Keychain, andCODEX_HOME=<folder> codex loginfor Codex. - Updated dependencies, including Tauri 2.12.5, Vite 8 and Playwright 1.64.
Margin v0.8.0
v0.8.0
2026-10-26 · Download
- Statusline:
margin --linenow shows both providers with session and weekly usage remaining and the time until each resets, in fixed columns so the line never jumps, with colours when Claude Code runs it. It picks the account of the folder your terminal uses.--shortkeeps the old one-account line,--alllists every account. See Command line. - Weekly digest: one notification on Monday mornings with last week's lowest remaining per account, how many sessions ran out, and the busiest day. Off by default; turn it on in Settings → Notifications → Weekly digest.
- Balances: Codex cards show credits and the monthly credit limit, and Claude cards keep extra usage, in a Balance block under the limits. Named Codex limits such as Spark show as chips next to the weekly limit.
- Codex plans with a single weekly limit now show it as Weekly, not Session, in the popover, the tray, alerts and the statusline. Existing history and alerts carry over.
- Make active covers the Codex desktop app: it shares the CLI sign-in, so switching works, and Margin asks you to quit the app and its background helper first.
Margin v0.7.0
v0.7.0
2026-10-26 · Download
- Make active: switch which account
claudeorcodexuses from Settings → Accounts. Margin swaps the sign-in of the default folder with the folder you choose, so both stay signed in, and keeps a backup. The account in the default folder shows an Active tag. Undo switches back. Codex must be closed first. - Fast usage alerts: get an alert when a session or weekly limit uses 10, 20 or 30% within an hour, with the time it runs out at that rate. Off by default; turn it on in Settings → Notifications.
- Command line:
margin --lineprints one line for statuslines, such as the Claude Code status line, andmargin --jsonprints every account's usage for scripts. Both read what Margin last saved and make no network requests. See Command line. - Claude accounts are read from the macOS Keychain before
.credentials.json, the same order Claude Code uses, and folders with non-English characters in their path now match their Keychain item.
Margin v0.6.0
v0.6.0
2026-10-25 · Download
- Accounts are ordered by usage remaining, lowest first, with the pinned account on top and signed-out accounts last. The order updates when you open Margin, not while you look. Change it in Settings → Appearance → Account order.
- Cards show the account's email next to the plan. Signed-out accounts show the exact sign-in command as a button that copies it.
- Opening Margin after a minute or more returns to the overview at the top.
- ⌘1 and ⌘2 switch between cards and compact (Ctrl+1 and Ctrl+2 on Windows). In compact, the limit that runs out first is shown in full ink, and the reset time belongs to it. ↑ and ↓ move between rows.
- "2 accounts need attention" is a button that jumps to the first one.
- Alerts and their settings use usage remaining, like the rest of the app: "Personal · Session 20% left", with the reset time in the body. The tray tooltip shows when the limit it follows resets.
- New installs follow the account with the lowest remaining in the tray and start in compact when three or more accounts are found.
- Margin does less work in the background. Opening it only refreshes readings older than 30 seconds, unchanged readings are stored once, and history files are about a third of their former size.
- Fixed an account getting stuck on "Checking usage" after Find accounts or a Keychain link changed its source.