v1.2.1 - Model Citizen

tokenuse 1.2.1, named Model Citizen, gives models the same first-class treatment projects already enjoy. Every canonical model now has a full overview page on the desktop — spend, sessions, token composition, per-tool split, effective pricing, and the projects behind it — and the TUI gains a matching model filter that scopes its dashboards the same way the project picker does. Around that headline, the release establishes a drill-in navigation pattern: detail pages remember where you came from, and rows that name a model or project are links wherever they appear. Everything is still computed from the usage files already on disk — no network calls, no LLM in the loop.

Highlights

• Desktop model pages: selecting a row on the Models catalog opens a dedicated page for that model — hero KPIs, Activity Pulse, its session list, a token-composition split, a per-tool donut, an effective-pricing panel, and By Project / By Activity breakdowns.
• TUI model filter: m opens a typeable model picker (mirroring the p project picker) that scopes Overview and Deep Dive to one canonical model, shown in the title bar next to the project filter.
• Drill-in navigation: project and model pages open with an origin-aware back chip that restores your scroll position, Esc steps back through chained drill-ins, and model rows are links everywhere the shared model table appears.
• Sample/demo mode supports the model scope end to end, with totals that still reconcile, and its model catalog now folds by canonical id across tools exactly like live data.

The model page

The Models catalog keeps its provider grouping and all five period columns, but rows now navigate instead of expanding inline. The model page scopes everything to that one canonical model across every tool, honouring the period and sort selectors:

• a KPI band with cost, calls, sessions, cache hit, average cost per call, and output tokens;
• the chronological Activity Pulse and the model's full session list, each row opening the session view;
• a token-composition panel splitting input, output, cache-read, and cache-write totals — the cache-economics view that was never surfaced per model before;
• the per-tool split as a donut (or plain numbers when only one tool used the model);
• an effective-pricing panel with the model's per-Mtok input, output, and cache rates, cache-rate percentages, and blended average cost per call. Rates come from the raw per-tool model ids, so tool-scoped aliases apply; when a model is billed via the pricing book's fallback row, the panel says so rather than presenting a guess as a price;
• By Project and By Activity tables showing where the model's spend actually goes, with project rows linking straight to project pages.

TUI model filter

m opens a typeable model picker listing every canonical model active in the current period with its cost and calls. Selecting one scopes Overview, Deep Dive, and the s session picker to that model; the title bar shows the active model alongside the tool and project filters, and all three compose independently. Pick All to clear it.

Drill-in navigation

Detail pages now remember where you came from. Opening a project or model page records the originating route and scroll position: the page opens with a back chip naming that origin, and clicking it — or pressing Esc — returns there with your scroll restored. Chained drill-ins (project → model → project) unwind one step at a time; navigating via the sidebar or nav keys ends the trail. Model rows are links on Overview's Top Models, Analytics, the tool pages, and each project page's Top Models, completing the project ↔ model cross-links in both directions. The pattern is documented in DESIGN.md as the standard for future entity pages.

Notes

• No archive migration: the schema stays at version 7 and older binaries can still open it.
• Local usage analysis remains local. Network use stays limited to confirmed Config-page downloads, opt-in quota sync, Windows/Linux update checks, and maintainer refresh or release paths.
• The release tag should be v1.2.1 and must match the root Cargo package, desktop Cargo package, desktop package.json, and Tauri config versions.

Full Changelog: v1.2.0...v1.2.1

Full Changelog: v1.2.0...v1.2.1