Usage 0.31.0

Released: 2026-09-27

Release notes

FEATURE

New Sketchbook Theme Turns Quotas into Grid-Paper Semicircle Gauges

If you find standard data interfaces monotonous, you can now switch to a more tactile style to track your usage. The newly added Sketchbook popover theme brings a graph paper texture to your screen. The interface renders each quota as a semicircle gauge with a needle, displaying large dark-ink percentages with highlighter underlines in each service’s representative color. Existing warning color schemes for 50% and 80% as well as the fixed 80% mark are fully retained across macOS and Windows, bringing the total number of popover themes to 15.

BUGFIX

Full Windows Popover Display Prevents Bottom Action Buttons from Being Clipped

When using the Windows version on high-resolution displays with shorter vertical heights, you no longer have to worry about bottom buttons being pushed offscreen. Previously, the popover relied on dimensions reported by pywebview (a library that renders web interfaces on the desktop), which often miscalculated space and cut off the "Update Now" and "Quit" buttons. Now, the popover directly queries Windows for the available area on the target display excluding the taskbar, and both the scale factor and window size are calculated from that same display so the bottom edge never exceeds the taskbar. Even if content cannot fit at the minimum readable scale, the popover automatically switches to a scrollable view.

BUGFIX

Antigravity Multi-Day Chats Track Turns Daily for Accurate Date Distribution

If you regularly keep the same AI conversation running over multiple days, usage charts now accurately reflect daily consumption. Starting with Antigravity CLI 1.1.18, the system no longer stores turn timestamps in their original location, which previously caused all usage across multi-day chats to be attributed to the first day. The application now reads individual turn timestamps from conversation steps (a table recording details for each interaction step). The system also proactively rebuilds the local cache once, recalculating and correcting all affected historical dates.

BUGFIX

Fix macOS Origami Theme Jitter to Stop Popover Scaling Conflicts

When selecting the origami-style popover on a Mac, the interface no longer suffers from annoying micro-jitters caused by competing size calculations. Previously on macOS, popover height and automatic scaling repeatedly triggered each other, causing the Origami theme interface to jitter continuously. Now, the application preserves sufficient height headroom during pure scale adjustments while ensuring it can still shrink properly as content changes. The development team also added browser regression tests (automated scripts that verify existing features remain unbroken), covering auto-fit stability and content switching.

Original changelog

Original changelogNew Sketchbook Theme Turns Quotas into Grid-Paper Semicircle Gauges
**Sketchbook panel theme.** A hand-drawn notebook look on grid paper: every quota shows as a half-circle gauge with a needle, the percentage sits in large ink over a highlighter stroke in each provider's color, and the 50% / 80% warning and danger colors and the fixed 80% mark still apply. Available on macOS and Windows; the panel count is now 15.
Original changelogFull Windows Popover Display Prevents Bottom Action Buttons from Being Clipped
Keep the whole Windows panel on screen on short high-DPI displays, so the Refresh Now and Quit buttons are no longer cut off ([#153](https://github.com/aqua5230/usage/issues/153)). The panel now reads the target monitor's work area straight from Windows instead of relying on the screen size pywebview reports, sizes the zoom and the window from the same monitor, never lets the window's bottom edge pass the taskbar, and becomes scrollable if even the smallest readable zoom cannot fit.
Original changelogAntigravity Multi-Day Chats Track Turns Daily for Accurate Date Distribution
Date Antigravity turns by their own time again. Antigravity CLI 1.1.18 and later no longer store a per-turn time where usage read it, so every turn of a multi-day conversation landed on the day it started. Turn times now come from the conversation's steps table, and the local caches are rebuilt once so older dates are recomputed.
Original changelogFix macOS Origami Theme Jitter to Stop Popover Scaling Conflicts
Stop panel height and automatic zoom from repeatedly adjusting each other on macOS, which could make Origami jitter. Keep a conservative height during zoom-only fitting while allowing changed content to shrink, and cover automatic-fit stability and content transitions in the browser regression.