Sign up
View stargazers0Sign up
Commits

README.md

Documentation

The repository keeps maintained documentation and current product screenshots. The documentation policy is in AGENTS.md. Every file under docs/ is listed below so new material has an explicit purpose. TODO.md tracks remaining Linux/Plasma parity with the official macOS app; the guides describe supported behavior. Agents maintain both through the documentation workflow.

Maintained references

  • Linux parity TODO: open Plasma work, official CLI blockers, and the last reviewed upstream release. Agents update it with each release.

  • Contributing: entry point for outside contributors, covering where to report what, checkout setup, and pull request requirements.

  • Security policy: supported versions and private vulnerability reporting for the widget.

  • Changelog: notable widget changes by version and unreleased changes. Future GitHub release notes come from this file.

  • Usage and settings: panel and popup options, provider setup, usage confidence, data freshness and quota cache limits, cost history, notifications, and widget defaults.

  • Development: QML ownership, regression checks, runtime verification, CI image maintenance and coverage gates, PR delivery and CI follow-up, repository maintenance, and agent instructions. Read before code or tooling changes.

  • Release skill: agent command sequence for a widget release, from changelog reconciliation to the verified tag run.

  • Parity review skill: agent command sequence for an upstream release review, including the isolated CLI probe.

  • Provider settings descriptor: proposed upstream CLI contract for generic settings. It is not a shipped contract.

  • Cost history: daily model data, selection behavior, and the pinned Linux CLI evidence behind the popup, plus the separate manual identified Codex token subtotal and its decoder limits.

  • Identified-token screenshot: synthetic local subtotal retained after an SSH-source failure, used in the usage guide.

  • AI Insights: the optional insight card's boundary decision, allowlisted snapshot, language selection, request and credential contracts, scheduling, and tests.

  • Translations: adding and checking a language catalog.

  • CLI 0.56.2 parity baseline: verified official Linux contracts at that comparison date. The usage guide describes current Plasma behavior; later scoped checks in the cost and settings documents do not replace this full audit.

  • 0.57.0 release review: Linux-relevant changes since 0.56.2, current Plasma gaps, and scoped official CLI probes.

  • 0.58.0 release review: release delta with no Linux CLI contract changes, feature classification against existing Plasma behavior, and scoped official CLI probes.

  • 0.60.4 release review: releases 0.59.0 through 0.60.4, source-observed credit-availability and detail-row fields, unchanged JSON schemas, and scoped official CLI probes. Cursor cost, provider descriptors, and generic config actions remain unavailable on Linux.

  • 0.60.5 release review: the new cost incompleteRequestCount contract verified in official Linux output, its unknown-not-zero day shape, and scoped official CLI probes. Provider descriptors, generic config actions, and Cursor cost remain unavailable.

  • 0.61.0 release review: the registry growth to 74 providers, the source-observed Grok reset-credit detail row, the live-only grokResetCredits property, and scoped official CLI probes. Provider descriptors, generic config actions, and Cursor cost remain unavailable.

  • 0.62.0 release review: the verified Muse token-history cost contract, the Codex-only --remote and --summary-only cost modes, the usage_updated hook event, invalid-total suppression in cost aggregation, and scoped official CLI probes. Provider descriptors, generic config actions, and Cursor cost remain unavailable.

  • 0.63.0 release review: the Pi registry growth with local token history and estimated costs, the still-rejected Cursor cost and descriptors probes, and scoped official CLI probes. Provider descriptors, generic config actions, and Cursor cost remain unavailable.

  • 0.64.1 release review: the Helmcode, v0, and TypeSafe registry additions, the Crof retirement, the measured split between v0's supported API-key setup and the two cookie-only providers, and scoped official CLI probes. Provider descriptors and generic config actions remain unavailable.

  • 0.65.0 release review: the Bifrost, Charm Hyper, and GitKraken AI registry additions and their Linux reachability, detail-row progress/usageValue and unknown named windows verified through a loopback Bifrost fixture, and checksum-verified official CLI probes. Provider descriptors, generic config actions, token-account writes, and Cursor cost remain unavailable.

  • 0.66.0 release review: the DevPass, Atlas Cloud, Vercel AI Gateway, and llmman registry additions and their API-key setup, llmman output verified through a loopback daemon fixture, the #3944 plugin-entry preservation in the tested config disable command, and checksum-verified official CLI probes. Provider descriptors, generic config actions, and Cursor cost remain unavailable.

  • 0.67.0 release review: the Aixy, Raycast, and xKiro registry additions and their Linux reachability, Aixy output verified through a loopback fixture, the cost --period flag and its reportingPeriod/historyLabel fields, and checksum-verified official CLI probes. Provider descriptors, generic config actions, Cursor cost, and display currency remain unavailable.

  • 0.69.0 release review: the 0.68.0 and 0.69.0 delta with an unchanged 87-provider registry, the Mistral manual-cookie runtime fix verified before and after, unchanged setup reachability for the migrated bundled-plugin providers, the still year-1 --period all day count, empty-config tolerance, and bubblewrap-isolated official CLI probes. Provider descriptors, generic config actions, Cursor cost, and display currency remain unavailable.

  • 0.72.0 release review: the 0.70.0 through 0.72.0 delta with the Muse, LithosAI, and WorkBuddy registry additions (90 records, same keys) and their cookie-only macOS-gated Linux reachability, the Claude manual-sessionKey runtime opening verified before and after, unchanged cost and usage envelopes with the still year-1 --period all day count, empty-config tolerance, and bubblewrap-isolated official CLI probes. Provider descriptors, generic config actions, Cursor cost, and display currency remain unavailable.

  • 0.73.0 release review: verified persistent provider-source writes, the 91-provider registry and Langdock's macOS-only reachability, ClinePass labeled-write rejection, unchanged empty cost/usage envelopes, and scoped bubblewrap-isolated official CLI probes. Distinguishes private Linux desktop snapshots from standard CLI usage and carries the unverified reset-credit and partial-priced output candidates.

  • 0.74.0 release review: the 100-provider registry with nine bundled-plugin additions and their Linux setup reachability, subscription renewal/expiration dates verified in Linux usage output through a loopback fixture, the Cursor cursor-agent login opening and its intermittent offline stall, unchanged account enumeration, and serve account discovery, with bubblewrap-isolated official CLI probes. Provider descriptors, generic config actions, Cursor cost, and display currency remain unavailable.

  • 0.74.1 release review: the OpenCode Go estimated-confidence mismatch verified with isolated local history and the Plasma normalizer, xAI generic detail-row compatibility, CLI-owned Command Code fixes, unchanged registry/help and empty envelopes, and carried blockers rechecked with bubblewrap-isolated official binaries.

  • 0.75.0 release review: the 103-provider registry, Command Code/fal API-key reachability, FLORA workspace and Parallel cookie blockers, identified-cost failure semantics, source-only throughput changes, and bubblewrap-isolated carried-blocker checks.

  • 0.76.0 release review: the 104-provider registry and Claude Platform's blocked Linux cookie setup, stable concurrent usage order, notice-archive compatibility, fast-probe verification, and carried blockers rechecked with the isolated official CLI.

  • 0.75.0 Codex contract verification: synthetic native partial-priced cost output, identified-request local/remote merge and failure semantics, authoritative reset-credit inventory, and the seeded historical-pricing output and remaining import verification limits.

  • 0.76.0 Claude detail contract: official Linux output for percentage-only resets and pace through an isolated synthetic Claude CLI, plus separate authenticated CLI/OAuth observations and exhausted-window forecast semantics.

  • Settings decisions: Panel disclosure and text grouping, Plasma settings, privacy, refresh behavior, the macOS 0.56.8 comparison, and the shared settings visual conventions.

Earlier CLI evidence

The 0.49.1 through 0.55.0 reports were superseded by the 0.56.2 audit, which re-verified their contracts, and were removed. They remain recoverable from Git history at commit ba0a0d8.

Product screenshots

These synthetic captures appear in the project README or usage guide. The README captures are also included in the widget package. Replace the relevant image when the product changes instead of adding dated before/after copies.

Store artwork

Historical work artifacts

Past captures, completed plans, and review logs are available in Git history before the cleanup. New temporary artifacts go in ignored dist/review/ or the OS temp directory. PRs record verification results; this index records documents worth maintaining.