nguyenphutrong/quotio
64.4
Adequate · 14 November 2026
107.9k
lines of production code
Swift
with Rust
5
measurements over time
What this system is
Features
Introduce Cloudflare Tunnel lifecycle management
Added domain models, an infrastructure service, and a presentation model to manage the Cloudflare Tunnel lifecycle. The new \CloudflaredService\ detects the \cloudflared\ binary, starts and stops the tunnel process, and parses the public URL from its output. The \TunnelScreenModel\ exposes the tunnel's state (idle, starting, active, stopping, error) and installation status to the UI, allowing users to start, stop, and monitor the tunnel's health.
Packages/QuotioCore/Sources/QuotioDomain/Tunnel, Packages/QuotioCore/Sources/QuotioInfrastructure/Tunnel, Packages/QuotioCore/Sources/QuotioPresentation/Tunnel · high confidence
Introduce Quotio CLI as the native host for account management, quota coordination, and companion sharing
This change adds the Quotio CLI infrastructure layer, which now serves as the primary backend for managing accounts, coordinating quota refreshes, and handling companion device sharing. The new \QuotioCLIBackend\ actor communicates with the Rust host via HTTP (v2 API) to discover native sources, authorize keychain access, and fetch quota snapshots, replacing previous direct storage mechanisms. A new \QuotioCLILegacyAccountMigration\ actor handles the import of existing accounts from local JSON metadata and the Codex Keychain, ensuring a smooth transition for existing users. Additionally, \QuotioCompanionService\ enables iPhone pairing and LAN/Tailscale sharing controls, while \QuotioCLIServerProcess\ manages the lifecycle of the embedded CLI helper binary. This shift centralizes account and quota logic in the CLI, allowing the UI to remain thin and focused on presentation.
Packages/QuotioCore/Sources/QuotioInfrastructure/QuotioCLI · high confidence
Introduce Quotio dashboard and quota presentation layer
The app now features a new Dashboard screen that provides a high-level overview of configured providers, the lowest remaining quota percentage, and the last refresh time, while highlighting providers that need attention (failed, partial, or outdated status). Quota details are presented via a redesigned ProviderQuotaView that merges accounts from auth files and quota data, supports both 'used' and 'remaining' display modes with distinct color coding, and groups metrics for clearer readability. The underlying QuotaScreenModel and QuotaFeatureController manage state, refresh cycles, and provider settings, ensuring that quota data is accurately reflected and updated.
Packages/QuotioCore/Sources/QuotioPresentation/Quota · high confidence
Introduce automated model warmup scheduling and custom provider management
This change introduces the core application-layer services for managing custom API providers and automating model warmup. It adds \CustomProviderService\ to handle the lifecycle (create, save, delete, validate) of custom provider configurations, including logic to normalize base URLs for OpenAI-compatible endpoints. Additionally, it implements the \WarmupSchedulerService\ and \ProxyWarmupExecutor\ to automatically schedule and execute warmup requests against Google's Antigravity API, ensuring models are primed according to configurable cadences and daily minute limits. The warmup executor includes specific model alias mappings for preview versions of Gemini and Claude models.
Packages/QuotioCore/Sources/QuotioApplication/Warmup · high confidence
Introduce companion connection modes and device pairing models
The companion service now supports connecting via local network, Tailscale, or proxy, allowing users to pair iPhones over these networks. New domain models define connection endpoints, network addresses, and device pairing credentials, enabling simultaneous LAN and Tailscale sharing while managing device access and expiration.
Packages/QuotioCore/Sources/QuotioDomain/Companion · high confidence
Introduce cross-cutting application ports
Added a new set of protocols in the application layer to define cross-cutting concerns, including logging, time, URL opening, clipboard access, notifications, and lifecycle management. This establishes a standardized interface for these system interactions within the application's architecture.
Packages/QuotioCore/Sources/QuotioApplication/Ports · high confidence
Introduce layered account model with multi-source login support
The domain layer now models accounts as a composite of an identity and multiple login sources, allowing a single account to maintain several authentication methods (such as native credentials, API keys, or legacy proxies) simultaneously. This change introduces new domain types like \AccountLoginSource\ and \AccountIdentity\ to track the status, capabilities, and credential metadata of each source independently, while also adding support for custom API providers (e.g., OpenAI, Claude, Gemini) with specific configuration options like model mapping and custom headers.
Packages/QuotioCore/Sources/QuotioDomain/Accounts · high confidence
Introduce macOS platform adapters and proxy update infrastructure
This change adds the macOS-specific implementation layer for core platform capabilities, including URL opening, pasteboard access, launch-at-login registration, application appearance/dock management, and system logging. It also introduces the Sparkle-based update adapter for the main application, a new image caching system with memory-pressure handling, and the infrastructure for CLI proxy updates via a GitHub Atom feed, including version comparison, caching, and notification recording. Finally, it implements the local notification delivery system for quota, account, and proxy lifecycle events.
Packages/QuotioCore/Sources/QuotioInfrastructure/Platform · high confidence
Introduce native iOS companion app and WidgetKit extensions
This change adds the initial iOS application and WidgetKit extensions, establishing the native iPhone companion for Quotio. The app connects to a local host via HTTPS with delegated read credentials, supporting direct LAN and Tailscale pairing modes. It features a dedicated design system with shared tokens for consistent UI across the app and widgets, including components like quota bars, tiles, and connection status indicators. The implementation includes account detail screens with usage analytics, privacy-focused account name blurring, and support for multiple widget families to display quota and usage data directly on the home screen.
apps/ios · high confidence
Introduce per-account quota history and usage forecasting
Quotio now tracks and displays a detailed history of quota usage for each account, allowing users to inspect observed states, usage amounts, and events over time ranges of 24 hours, 7 days, or 30 days. The interface includes a chart to visualize usage trends, with indicators for whether the current pace will exhaust the quota before the next reset. Users can also forecast how long their remaining quota will last based on current usage rates, with options to pause or clear history recording.
apps/macos/Quotio · high confidence
Introduce persistent usage cache and local HTTP management server
The CLI now persists provider usage data to disk via a new \UsageCache\ (apps/cli/src/cache.rs), allowing the local HTTP server (apps/cli/src/server.rs) to serve cached usage reports without immediate provider fetches. This is supported by a new TOML configuration system (apps/cli/src/config.rs) for managing provider enablement, cache TTL, and refresh intervals, alongside a new v2 API contract (apps/cli/src/contract.rs) for structured account and usage snapshots. The CLI also gains new commands for managing companion devices and LAN/Tailscale sharing (apps/cli/src/devices.rs), enabling read-only access for other local tools.
apps/cli/src · high confidence
Introduce platform abstraction for runtime identity and update policies
This change introduces new domain models in the Platform layer to abstract platform-specific behaviors. It defines \RuntimeIdentity\ to distinguish between production and beta environments, isolating their state by using separate bundle identifiers, application support directories, and proxy ports (8317 for production, 8318 for beta). It also adds \ApplicationUpdatePolicy\ and \ApplicationUpdateSnapshot\ to support automatic updates via Sparkle for the beta feed, while \SemanticNotification\ and \NotificationSettingsSnapshot\ provide structured models for notification states and preferences.
Packages/QuotioCore/Sources/QuotioDomain/Platform · high confidence
Introduce proxy lifecycle management and domain models
The proxy subsystem now includes explicit lifecycle state management (idle, starting, active, stopping, downloading, testing, promoting, rolling back) with strict transition rules enforced by a state machine. New domain models define proxy endpoints, status, version information (including SHA256 and download URLs), and usage statistics. Authentication file management is modeled with detailed provider-specific lookup keys and status tracking. Proxy failure modes are explicitly enumerated (binary not found, startup failed, network errors, checksum mismatches, etc.) and notifications for crashes, upgrades, and rollbacks are standardized.
Packages/QuotioCore/Sources/QuotioDomain/Proxy · high confidence
Introduce tunnel lifecycle controller and protocols
The application now includes a new \TunnelLifecycleController\ and associated protocols (\TunnelControlling\, \TunnelRemoteAccessControlling\, \TunnelLifecycleControlling\) to manage the Cloudflare tunnel's state. This controller handles starting, stopping, and monitoring the tunnel, including automatic restart attempts with configurable timeouts and delays. It exposes the tunnel's status via an \AsyncStream\ of snapshots, allowing the UI to react to changes in the tunnel's connection state.
Packages/QuotioCore/Sources/QuotioApplication/Tunnel · high confidence
Introduces layered persistence and custom provider support
This change adds new infrastructure for persisting application state and managing custom AI providers. It introduces a layered architecture for preferences, moving storage from a single flat structure to dedicated repositories for operating mode, menu bar settings, refresh/warmup schedules, and provider tracking, including migrations for legacy macOS provider IDs. It also adds support for custom providers, allowing users to configure and persist third-party API endpoints via YAML files or local storage, with logic to serialize, deserialize, and manage these configurations. Additionally, it implements secure, atomic file writing for account metadata and snapshots, and introduces repositories for managing proxy configuration, versioning, and authentication files.
Packages/QuotioCore/Sources/QuotioInfrastructure/Persistence · high confidence
Introduces platform abstraction layer for updates, notifications, and launch settings
This change adds a new set of platform-specific controllers and protocols in the QuotioApplication platform layer to manage application update channels (including beta support), notification preferences and delivery, and macOS launch-at-login behavior. Users will experience more granular control over update channels, reliable notification handling with deduplication and threshold-based alerts, and consistent launch-at-login management, all exposed through a unified platform interface.
Packages/QuotioCore/Sources/QuotioApplication/Platform · high confidence
Native terminal usage reports with JSON export
The CLI now renders usage data directly in the terminal using the Tern UI library, replacing previous output methods with structured cards that display account badges (plan, freshness, issues), quota meters, and reset details. A new JSON output module has been added to allow programmatic access to the usage snapshot.
apps/cli/src/output · high confidence
New API Keys management screen and redesigned About screen
Users can now manage API keys directly within the app via a new API Keys screen, which allows generating, adding, editing, copying, and deleting keys while requiring the proxy to be running. The About screen has been redesigned with a new layout featuring version badges, update cards, and links to GitHub and support resources.
Packages/QuotioCore/Sources/QuotioPresentation/Screens · high confidence
New CLI distribution and release tooling
The CLI now includes a complete set of scripts to build, sign, and package the application for distribution. This adds macOS code signing and notarization (via \ci-sign-macos.sh\ and \sign-macos.sh\), an npm launcher (\distribution/npm/bin/quotio.cjs\) that bundles native binaries for macOS and Linux, and a release packaging script (\package-release.py\) that generates Homebrew formulae and npm tarballs. It also introduces dependency security scanning against OSV advisories (\check-advisories.py\) and automated generation of third-party license notices (\third-party-notices.py\).
apps/cli/scripts · high confidence
New account management API with native source discovery and encrypted vault support
The CLI now exposes a comprehensive account management system via a new API layer in \apps/cli/src/accounts\. Users can add, list, use, and remove accounts through explicit commands, supporting both API keys and native credential sources (such as GitHub Keychain, Claude Code, and Factory) discovered automatically by the host. The system introduces a new \AccountDto\ for structured account data and supports patching account properties like labels and enabled status. Security is enhanced with a new encrypted file backend for headless Linux environments, allowing vault storage with a separate master key file or file descriptor. Additionally, a migration module allows importing legacy Quotio monitor credentials, and a companion TLS identity system enables secure local network communication for the CLI.
apps/cli/src/accounts · high confidence
New centralized development script for building and testing apps
A new \scripts/dev\ entry point has been added to streamline local development workflows. This script provides unified commands to run the CLI (\cli\), build and run the macOS app (\macos\), launch the iOS app in a simulator (\ios-sim\) or on a physical device (\ios-device\), and run tests across all platforms (\test\). The macOS and iOS device targets now require a \Local.xcconfig\ file to be configured with a development team, ensuring proper code signing and keychain access.
scripts · high confidence
New companion device control protocol for iPhone pairing
The application now exposes a \CompanionControlling\ protocol that defines the interface for managing iPhone companion devices. This interface allows the system to check connection status, configure network settings (including local network or Tailscale), retrieve paired devices, and issue or revoke pairing permissions, laying the groundwork for the new iPhone pairing and sharing controls.
Packages/QuotioCore/Sources/QuotioApplication/Companion · high confidence
New dashboard overview screen with provider attention alerts
The dashboard now features a new MonitorOverviewScreen that displays a summary of configured providers, the lowest available quota percentage, and the last refresh time. It also highlights providers requiring attention (failed, partial, or outdated status) with direct navigation links, allowing users to quickly identify and address issues with their connected accounts.
Packages/QuotioCore/Sources/QuotioPresentation/Dashboard · high confidence
New local HTTP management server with native discovery and companion sharing
The CLI now includes a local HTTP server that exposes a versioned v2 API for account management, native source discovery, and companion sharing. Users can discover and register native credentials (e.g., Grok, Copilot, ClinePass) via the /v2/sources/discover endpoint, manage accounts and sources through /v2/accounts and /v2/sources, and control read-only companion access over local network or Tailscale via the sharing module. The server enforces strict security policies, including HMAC-based authentication, idempotency keys for mutations, and owner-only restrictions for sensitive operations, and publishes its OpenAPI contract at /openapi.json.
apps/cli/src/server · high confidence
New local proxy-based OAuth authentication flows for Copilot and Kiro
The Accounts infrastructure now supports authenticating via a local proxy CLI for Copilot and Kiro providers, replacing or supplementing previous methods. This introduces a new \LocalProxyOAuthAuthorizer\ that manages the authorization lifecycle, including browser-based flows for Copilot and specific device-code or import flows for Kiro. A new \ProcessProxyCLIAuthenticator\ handles the execution of the proxy CLI commands, capturing output to extract device codes and reporting standardized authentication statuses. Additionally, a \FileAntigravityAuthWorkaround\ component automatically patches local authentication configuration files to point to the correct Google API base URL, ensuring seamless integration with the proxy.
Packages/QuotioCore/Sources/QuotioInfrastructure/Accounts · high confidence
New macOS build, release, and architecture validation scripts
The macOS build workflow now uses dedicated shell scripts in \apps/macos/scripts\ to manage the development and release lifecycle. \build\_and\_run.sh\ streamlines local Debug builds with options for debugging, log streaming, and telemetry verification. \build\_dmg.sh\ automates the creation of Release DMG and ZIP artifacts, supporting Developer ID signing, Apple notarization (via notarytool or App Store Connect), and Sparkle appcast generation for both stable and beta releases. A new \build\_cli\_helper.sh\ script compiles the Rust CLI tool, creates universal binaries, and embeds it into the app bundle. Additionally, \check\_architecture.sh\ enforces strict layering rules for the Swift codebase, preventing lower layers from importing UI or infrastructure modules and ensuring retired components are not wired into the production graph.
apps/macos/scripts · high confidence
New multi-step onboarding wizard for provider setup and quota configuration
The onboarding experience has been replaced with a structured, multi-step wizard that guides users through connecting providers, managing native source permissions, and configuring quota monitoring. The flow includes a welcome screen, a provider connection step for OAuth and API key setup, an access step for resolving permission requests, and a completion step that summarizes connected providers and allows toggling the menu bar quota display. This change introduces new presentation components (OnboardingFlow, AccessStep, CompletionStep, ProviderStep, WelcomeStep) and supporting models (OnboardingProviderOverview, OnboardingViewModel) to manage the state and navigation of this guided setup process.
Packages/QuotioCore/Sources/QuotioPresentation/Onboarding · high confidence
New provider adapters for Amp, Antigravity, and Codex
The CLI now includes dedicated provider adapters for Amp, Antigravity, and Codex, enabling the tool to fetch and display usage quotas and account details for these services. The Amp adapter parses local CLI output to present usage windows and balances, while the Antigravity adapter supports both API-based quota fetching and local service discovery on macOS to read subscription metadata and usage limits. The Codex adapter integrates with the local application server and external API to report session and weekly rate limits, alongside extra usage credits. These adapters are registered in the provider capabilities system, exposing specific actions like API key addition and native source discovery to the user.
apps/cli/src/providers · high confidence
New provider catalog for usage and quota tracking
The CLI now includes a comprehensive provider catalog in \apps/cli/src/providers/catalog\ that automatically discovers and fetches usage data for a wide range of AI providers. This new module adds support for Azure OpenAI (via Cost Management), balance-based providers like DeepSeek and Moonshot, coding plan providers such as Alibaba and Warp, infrastructure providers like Fireworks and Groq, and gateway aggregators including LiteLLM and OpenAI organization usage. It also introduces native credential handling for Devin Desktop and secure SQLite WAL reading for Cursor login recovery, along with a shared \common\ module for standardized usage parsing and a test suite for file-safety guarantees.
apps/cli/src/providers/catalog · high confidence
Standardized provider branding and account source localization
The shared presentation layer now centralizes how AI providers and account sources are displayed. For each supported provider (such as Claude, Codex, and GitHub Copilot), the system defines specific display names, SF Symbols, logo asset names, brand colors, menu bar icons, and OAuth endpoints, ensuring consistent visual identity across the app. Additionally, account sources (like Quotio Keychain or Local IDE) now have localized display names, and the \Color\ type includes a hex initializer to support these brand colors.
Packages/QuotioCore/Sources/QuotioPresentation/Shared · high confidence
Unified account and agent management UI components
The ProvidersScreen now uses a new set of presentation components to organize and display accounts and agents. AccountRow replaces previous row types (AuthFileRow, DirectAuthFileRow, AutoDetectedAccountRow) with a unified view that distinguishes account sources (proxy, disk, auto-detected, monitor) and exposes specific capabilities like disable, edit, and switch based on the account type. Accounts are grouped by provider via ProviderAccountsGroup, and an empty state (AccountsEmptyState) guides users to scan IDEs or add providers manually. Agent configuration is handled by AgentCard and AgentConfigSheet, supporting both automatic and manual setup modes with proxy-specific options and backup restoration. Additional UI elements include CurrentModeBadge for sidebar mode indication, AvailableModelsSection for proxy model catalog display with copy-to-clipboard, and OAuthSheet for provider authentication flows.
Packages/QuotioCore/Sources/QuotioPresentation/Components · high confidence
Removals
Removal of default SwiftUI app entry point
The default \ContentView\ and \QuotioApp\ entry point files have been removed from the Quotio module. This eliminates the boilerplate "Hello, world!" SwiftUI window that was previously the application's main interface, indicating that the app's UI structure is being redefined or replaced by other components.
Quotio · high confidence
Architecture
Introduces layered core module structure
The QuotioCore package now defines a layered architecture consisting of Domain, Application, Infrastructure, and Presentation modules. Each layer is represented by a dedicated module file that declares its name and explicit dependencies on other layers (e.g., Infrastructure depends on both Application and Domain), establishing the foundational structure for the application's code organization.
(repo-wide) · high confidence
Behavioural changes
17 commits (7 fixes) modifying apps/desktop
A change to existing behaviour in apps/desktop — 17 commits (7 fixs), 93 files: “feat(desktop): install, run and update CLIProxyAPI”; “feat(desktop): replace popup densities with four quota styles”; “feat(desktop): add GPUI tray app for macOS, Linux and Windows (\#568)”; and 14 more (refs \#568).
apps/desktop · medium confidence · unverified
Centralized language management with main-actor isolation
The app now uses a dedicated \LanguageManager\ to handle localization, ensuring all state updates occur on the main actor to prevent concurrency issues. When a user changes their language preference, the system automatically updates the localization bundle and notifies observers, providing a consistent and thread-safe experience for switching between English, Vietnamese, Chinese, and French.
Packages/QuotioCore/Sources/QuotioPresentation/Resources · high confidence
Improved reliability for Antigravity account switching and token management
The Antigravity account switcher now handles token refresh failures and machine identity sync errors more gracefully, ensuring that switch operations can be rolled back safely if they fail midway. Additionally, token refresh logic has been updated to handle cases where the expiry time is unknown, preventing potential authentication issues during account switches.
Packages/QuotioCore/Sources/QuotioInfrastructure/Antigravity · high confidence
Introduce infrastructure implementations for lifecycle primitives
The Lifecycle module now includes concrete infrastructure implementations for core lifecycle primitives. ContinuousSleeper provides the Sleeping protocol by wrapping async task sleeping, and SystemDateProvider provides the DateProviding protocol by returning the current system date, enabling the application to manage time-based operations and date access through these new infrastructure components.
Packages/QuotioCore/Sources/QuotioInfrastructure/Lifecycle · high confidence
Introduce layered architecture for proxy logs with UI support
This change restructures the proxy logging system into a layered architecture, introducing a domain model (LogEntry with automatic level detection), application use cases (loading with retention policies and clearing), and an infrastructure client (ManagementAPIClient) that fetches and clears logs via a management API. On the presentation side, a new SwiftUI LogsScreen allows users to view, search, and filter logs by level (info, warn, error, debug), with auto-scrolling, manual refresh, and clear functionality.
(repo-wide) · high confidence
Introduce layered presentation models for account management and OAuth flows
The Accounts presentation layer now uses dedicated screen models (AccountsScreenModel and OAuthScreenModel) to manage state and user interactions. AccountsScreenModel exposes account lists, native source permissions, and storage problems, while handling actions like rescanning native accounts, authorizing sources, adding local accounts, and managing API keys. OAuthScreenModel manages the OAuth flow lifecycle, observing state changes from the underlying controller and triggering success handlers. This change decouples the UI state management from the core account service logic, providing a cleaner interface for the presentation layer to interact with account and OAuth operations.
Packages/QuotioCore/Sources/QuotioPresentation/Accounts · high confidence
Introduce layered settings architecture with dedicated preference repositories
The application's settings management has been restructured into a layered architecture. This change introduces a new \MonitoringSettingsManaging\ protocol to handle monitoring provider configurations and establishes a comprehensive set of typed preference repositories (e.g., \ProviderTrackingPreferencesRepository\, \ProxyPreferencesRepository\, \AppShellPreferencesRepository\) to manage specific user preferences such as appearance, language, notifications, and proxy settings.
Packages/QuotioCore/Sources/QuotioApplication/Settings · high confidence
Introduce layered settings architecture with new domain models
The Settings domain has been restructured into a layered architecture, introducing new domain models to manage configuration and state more explicitly. This includes \MonitoringProvider\ and \MonitoringSettings\ to handle provider-specific monitoring configurations, \ProviderTrackingPreferences\ to manage provider enablement and login discovery, and \OperatingModePreferences\ to replace the previous operating mode selection with a simplified monitor/local proxy choice. Additionally, \PreferenceValues\ now defines granular preferences for the menu bar (including quota display modes, styles, and color themes), refresh cadences, and warmup intervals, providing a more structured foundation for user settings.
Packages/QuotioCore/Sources/QuotioDomain/Settings · high confidence
Introduce native Rust host client with secure discovery and companion support
The QuotioHostClient package now provides a native Swift implementation for communicating with the Rust host, replacing previous transport mechanisms. It introduces a new discovery protocol that allows the client to independently scan for and register host sources, and adds support for companion device status and revocation via dedicated API endpoints. Security is strengthened by enforcing HTTPS for remote connections, rejecting plaintext HTTP for non-loopback hosts, and validating TLS connections against specific paired trust anchors rather than system defaults. The client also decodes a comprehensive v2 snapshot containing account, source, and quota metrics, along with supplemental usage data like reset credits and subscription status, ensuring type-safe and validated data exchange with the host. Also in this area: Support for connecting local accounts from custom config directories.
Packages/QuotioHostClient · high confidence
Introduce structured domain models for quota providers, metrics, and refresh states
The Quota domain layer now uses explicit Swift structs and enums to represent quota data, replacing previous ad-hoc or opaque representations. QuotaProvider defines supported AI providers (e.g., claude, codex, cursor) with specific capabilities such as quota-only tracking, browser-based auth, CLI usage, and API-key auth. QuotaMetric and QuotaMetricPresentation model usage metrics with units (usd, credits, requests, searches) and presentation modes (progress, amount, status). QuotaRefreshState and QuotaRefreshFailureReason standardize refresh outcomes and error reasons. Additionally, WarpToken models named, enabled/disabled API tokens. These changes provide a consistent, type-safe foundation for quota tracking and display across the app.
Packages/QuotioCore/Sources/QuotioDomain/Quota · high confidence
Introduces layered account management with native credential discovery and OAuth flow control
The Accounts module now uses a new layered architecture that separates account metadata, credential storage, and authentication logic. Users benefit from automatic discovery of native login sources (such as macOS Keychain entries) and the ability to authorize or manage these sources directly within the app. The new AccountService and CredentialVault handle credential persistence with generation-based conflict resolution, while the OAuthFlowController and OperatingModeOAuthAuthorizer manage authentication states, supporting both monitor and local-proxy modes. This change also introduces explicit handling for auth file sources and provider-specific settings, allowing users to see which accounts need identification or re-authentication and to trigger rescans of native logins.
Packages/QuotioCore/Sources/QuotioApplication/Accounts · high confidence
Introduces new quota coordination and monitoring abstractions
This change introduces new Swift types and protocols in the Quota package to support a layered architecture for quota management. Specifically, it adds \AccountMonitoringState\ to track individual account connection and refresh status, and \QuotaSnapshot\ to aggregate provider names, account states, quotas, subscriptions, and refresh issues into a single view. It also defines \QuotaPorts.swift\, which contains the \QuotaCoordinating\ protocol for managing quota operations (bootstrap, refresh, cancel) and request structures like \QuotaFetchRequest\ and \QuotaRefreshIssue\. Additionally, a \WarpTokenRepository\ protocol is added to abstract token persistence. These changes provide the structural foundation for the new quota state management and monitoring capabilities.
Packages/QuotioCore/Sources/QuotioApplication/Quota · high confidence
Migrate legacy YubiKey-protected credentials to standard Keychain storage
The credentials infrastructure now automatically migrates protected credentials previously stored in YubiKey envelopes to the standard macOS Keychain. Existing users will see their legacy YubiKey-protected secrets read once and then saved to the new Keychain service, after which the system stops writing to the YubiKey vault. This migration is transparent and preserves access to existing credentials while retiring the legacy hardware-backed write path.
Packages/QuotioCore/Sources/QuotioInfrastructure/Credentials · high confidence
New proxy management and screen models for the presentation layer
The proxy presentation layer now uses dedicated screen models to manage the proxy lifecycle and configuration. ProxyScreenModel exposes the proxy's operational state (running status, port, version info, upgrade availability) and handles actions like starting, stopping, toggling, and managing binary versions. ProxyManagementScreenModel coordinates the broader management context, including account and OAuth states, tunnel preferences, and quota refresh settings. It manages the connection to the CLIProxyAPI management interface, fetching and syncing authentication files, usage statistics, and API keys, while handling errors and configuration updates such as proxy URLs and routing strategies.
Packages/QuotioCore/Sources/QuotioPresentation/Proxy · high confidence
Proxy lifecycle and update polling restructured into layered architecture
The proxy management system has been refactored to use a layered architecture, introducing a new \ProxyLifecycleController\ that coordinates process control, version management, and configuration via explicit protocols (defined in \ProxyPorts.swift\). This change centralizes the proxy's state machine and health monitoring, while a new \ProxyUpdatePollingController\ handles periodic upgrade checks and notification delivery. Users benefit from more robust proxy startup, health recovery, and update notification flows, with the management API and configuration logic now clearly separated from the core lifecycle logic.
Packages/QuotioCore/Sources/QuotioApplication/Proxy · high confidence
Proxy release updates now fall back to web pages when GitHub API is rate-limited
The proxy infrastructure now handles GitHub API rate limits gracefully. When fetching release information (latest, specific tag, or list) via the API fails due to rate limiting (HTTP 429 or 403 with remaining=0), the system automatically falls back to parsing the corresponding GitHub web pages to retrieve the release tags and details. This ensures that proxy version checks continue to work even when the GitHub API is throttled, preventing update failures for users.
Packages/QuotioCore/Sources/QuotioInfrastructure/HTTP · high confidence
Quotio macOS app restructured with new lifecycle and credential migration
The macOS app has been reorganized into a new \Quotio/App\ module, introducing a dedicated \AppDelegate\ and \AppRuntime\ to manage the application lifecycle, window visibility, and status bar integration. This change includes a new \AppIdentity\ system that migrates user preferences and keychain credentials from legacy bundle identifiers (\dev.quotio.desktop\, \proseek.io.vn.Quotio\) to the production identity (\app.bytrong.quotio\), ensuring seamless continuity for existing users. The app now supports accessory mode (hiding from the Dock) while correctly promoting to regular mode when the main window is activated, and it handles clean shutdowns by managing proxy cleanup and OAuth sessions.
apps/macos/Quotio/App · high confidence
Redesigned macOS menu bar with native menu, companion pairing, and refined quota display
The macOS menu bar interface has been rebuilt to use a native NSMenu with SwiftUI hosting views, providing a more integrated Liquid Glass appearance and improved multi-monitor support. Users can now pair iPhones directly from the menu bar via a new companion popover, and quota metrics are rendered with native tooltips and provider-specific filtering. The display logic has been refined to show only enabled quota accounts, separate extra usage from host metric groups, and preserve host-resolved plan names, while settings for refresh cadence and appearance are now persisted and applied consistently. Also in this area: Improved quota failure visibility and menu stability on macOS.
Packages/QuotioCore/Sources/QuotioPresentation/MenuBar · high confidence
Redesigned settings interface with new account management and companion pairing
The Settings screen has been reorganized around a provider hierarchy, introducing a dedicated Accounts view that displays accounts grouped by provider with simplified rows showing plan and source details. Users can now manage account pinning to the menu bar, pause accounts, and view per-account quota history directly from the row context menu. A new About page consolidates version information, update controls, and links. Companion setup is streamlined with a dedicated pairing view supporting both local network and Tailscale connections, including QR code generation for iPhone pairing. Additional improvements include a new CLIProxy settings page for managing the proxy binary, an appearance settings section, and a storage access section for handling Keychain authorization issues.
Packages/QuotioCore/Sources/QuotioPresentation/Settings · high confidence
Redesigned settings navigation with provider-centric hierarchy
The macOS settings interface has been reorganized to center around provider management. A new sidebar navigation structure now distinguishes between provider-related accounts (displayed via the 'Providers' section) and general application settings (such as General, Proxy, and Notifications). This change introduces a dedicated navigation model that manages state between the provider list and specific account details, allowing users to select a provider to view its associated settings and quota information, while maintaining access to global app preferences in a separate section.
Packages/QuotioCore/Sources/QuotioPresentation/App · high confidence
Standardized connection source labels and error explanations
The presentation layer now provides consistent, localized labels for various native connection sources (such as Amp, Claude, Kiro, and Cursor) and standardized error explanations for quota refresh issues (like authentication failures or rate limiting). This ensures that users see clear, uniform messaging regarding their connection status and any associated errors across the application.
Packages/QuotioCore/Sources/QuotioPresentation/Providers · high confidence
macOS app project restructured with test support and localization updates
The macOS Quotio project has been moved to the apps/macos directory and reconfigured to include a dedicated unit test target (QuotioTests) and a Config group for build settings. The app now embeds the Quotio CLI helper and links against internal framework packages (QuotioDomain, QuotioApplication, QuotioInfrastructure, QuotioPresentation). Localization support has been updated to include Vietnamese (vi) and Simplified Chinese (zh-Hans) alongside French, replacing the previous Base localization.
apps/macos/Quotio.xcodeproj · high confidence
Fixes
CLI launches without Node.js and includes missing license files
The CLI distribution now ships a POSIX shell launcher (apps/cli/distribution/npm/bin/quotio) that invokes the native binary directly, allowing the tool to run in environments where Node.js is not on the PATH (such as GUI apps or launchd jobs). This change is accompanied by the addition of missing upstream dependency license texts (asn1-rs-impl-0.2.0 and tern-sdk-0.1.0) to the distribution bundle and includes tests to verify the launcher's behavior across supported platforms.
apps/cli/distribution · high confidence
Introduce host-resolved quota snapshots and account source normalization
The CLI contract layer now includes new modules for generating provider-neutral account snapshots and computing host-owned quota summaries. The snapshot logic normalizes provider metric names and groups matching login sources, ensuring that external accounts are correctly identified and merged based on verified identity evidence. Simultaneously, the summary module computes uniform quota metrics (session, combined, and paired metrics) for supported providers like Claude, Codex, and Cursor, preserving host-resolved plan names across frontends and handling missing session resets consistently.
apps/cli/src/contract · high confidence
Test coverage
Added integration and unit tests for CLI cache, collection, and server management; Added presentation-layer tests for account, companion, and agent setup screens; Added tests for account persistence, agent configuration, and infrastructure components; Added tests for app identity, runtime lifecycle, and localization; Added tests for quota history timeline and conflict handling; Added unit tests for QuotioDomain models and configuration; Added unit tests for application core services and state management.
Dependencies
Initial dependency manifests for Quotio CLI and Swift packages
The project now includes the initial dependency configuration files for its core components. The Rust-based CLI (apps/cli) is defined with Cargo.toml and Cargo.lock, specifying dependencies such as axum 0.8, rustls 0.23, and clap 4, and targeting Rust edition 2024. Swift package manifests (Package.swift) and resolved lock files (Package.resolved) are added for the QuotioCore, QuotioHostClient, and QuotioMobile packages, establishing a shared host client dependency and pinning the Sparkle update framework to version 2.8.1 for macOS and iOS targets. Also in this area: CLI version bump to 1.0.0-beta.4; Update CLI dependencies to address security advisories. Also in this area: 1 commit updating dependencies (3 manifests); 3 commits updating dependencies (3 manifests).
(dependencies) · medium confidence · unverified
Housekeeping
Removed user-specific scheme configuration from version control
The per-user scheme management file (xcschememanagement.plist) has been deleted from the repository. This change ensures that individual developer settings, such as scheme order hints, are no longer tracked in version control, preventing unnecessary merge conflicts and keeping the project configuration clean for all collaborators.
Quotio.xcodeproj · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 65 → 64 (-0.1)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 79 → 72 (-7.6)
- Architecture 94 → 94 (+0.6)
- Maturity 66 → 70 (+3.8)
- Readiness 59 → 60 (+0.2)
- Security 89 → 84 (-4.7)
- Domain Modelling 100 → 100 (+0.0)
- Performance 60 → 60 (+0.0)
Resolved (19)
- Duplicated block (12 lines × 7) (Packages/QuotioCore/Sources/QuotioApplication/Proxy/ProxyLifecycleController.swift)
- Duplicated block (12 lines × 7) (Packages/QuotioCore/Sources/QuotioApplication/Quota/QuotaPorts.swift)
- Duplicated block (5 lines × 2) (Packages/QuotioCore/Sources/QuotioDomain/CustomProviders/CustomProviderModels.swift)
- Duplicated block (5 lines × 2) (apps/ios/Sources/QuotioMobile/ConnectionIssue.swift)
- Duplicated block (5 lines × 2) (apps/ios/Sources/QuotioMobile/DisplayNames.swift)
- Duplicated block (6 lines × 2) (Packages/QuotioCore/Sources/QuotioDomain/Accounts/AntigravitySwitchModels.swift)
- Duplicated block (6 lines × 2) (Packages/QuotioCore/Sources/QuotioInfrastructure/Persistence/FileAccountMetadataRepository.swift)
- Hotspot: Packages/QuotioCore/Sources/QuotioInfrastructure/Accounts/LocalProxyOAuthAuthorizer.swift (Packages/QuotioCore/Sources/QuotioInfrastructure/Accounts/LocalProxyOAuthAuthorizer.swift)
- Hotspot: Packages/QuotioCore/Sources/QuotioPresentation/App/PresentationValues.swift (Packages/QuotioCore/Sources/QuotioPresentation/App/PresentationValues.swift)
- Hotspot: Packages/QuotioCore/Sources/QuotioPresentation/Components/OAuthSheet.swift (Packages/QuotioCore/Sources/QuotioPresentation/Components/OAuthSheet.swift)
- Hotspot: Packages/QuotioCore/Sources/QuotioPresentation/Shared/ProviderPresentation.swift (Packages/QuotioCore/Sources/QuotioPresentation/Shared/ProviderPresentation.swift)
- Hotspot: apps/cli/src/accounts/oauth.rs (apps/cli/src/accounts/oauth.rs)
- Hotspot: apps/cli/src/accounts/sources.rs (apps/cli/src/accounts/sources.rs)
- Hotspot: apps/cli/src/interactive.rs (apps/cli/src/interactive.rs)
- Hotspot: apps/cli/src/output/text.rs (apps/cli/src/output/text.rs)
- Medium vulnerability: [GHSA redacted] (apps/cli/Cargo.lock)
- Members sharing a duplicated core (4 members, 50+ identical tokens) (Packages/QuotioCore/Sources/QuotioInfrastructure/Accounts/LocalProxyOAuthAuthorizer.swift)
- Members sharing a duplicated core (9 members, 50+ identical tokens) (Packages/QuotioCore/Sources/QuotioApplication/Proxy/ProxyLifecycleController.swift)
- No ADRs found
New (124)
- ClassTooLong: ConnectFlow (apps/desktop/src/ui/settings/connect.rs)
- ClassTooLong: QuotaHistory (apps/desktop/src/ui/settings/history.rs)
- Duplicated block (10 lines × 2) (apps/desktop/src/ui/settings/general.rs)
- Duplicated block (12 lines × 2) (apps/desktop/src/ui/settings/connect.rs)
- Duplicated block (13 lines × 2) (apps/desktop/src/ui/menu.rs)
- Duplicated block (14 lines × 2) (apps/desktop/src/ui/menu.rs)
- Duplicated block (14–16 lines × 2) (apps/desktop/src/app.rs)
- Duplicated block (15 lines × 2) (apps/desktop/src/theme.rs)
- Duplicated block (5 lines × 2) (apps/desktop/src/app.rs)
- Duplicated block (5 lines × 2) (apps/desktop/src/host.rs)
- Duplicated block (5 lines × 2) (apps/desktop/src/store.rs)
- Duplicated block (5 lines × 3) (apps/desktop/src/ui/settings/accounts.rs)
- Duplicated block (6 lines × 2) (Packages/QuotioCore/Sources/QuotioInfrastructure/Persistence/FileAccountMetadataRepository.swift)
- Duplicated block (6 lines × 2) (apps/desktop/src/notifier.rs)
- Duplicated block (6 lines × 2) (apps/desktop/src/ui/settings/accounts.rs)
- Duplicated block (7 lines × 2) (apps/desktop/src/ui/settings/connect.rs)
- Duplicated block (8 lines × 2) (apps/desktop/src/ui/settings/accounts.rs)
- Duplicated block (8–9 lines × 2) (apps/desktop/src/autostart.rs)
- Duplicated block (8–9 lines × 2) (apps/desktop/src/ui/menu.rs)
- Duplicated block (9 lines × 2) (apps/desktop/src/ui/settings/accounts.rs)
- …and 104 more
Changes since last survey
- 27 commits — 15 feature/other, 12 fixes
By area
- apps/desktop — 17 commits
- apps/cli — 5 commits
- .github/workflows — 2 commits
- specs/gpui-cutover — 2 commits
- (root) — 1 commit
Notable commits
- fix: fix(accounts): preserve logical IDs and receipts during adoption
- fix: fix(accounts): recheck receipt bytes after directory sync
- fix: fix(companion): distinguish TLS leaf from existing CA
- fix: fix(deps): remove unmaintained pin-utils dependency
- fix: fix(deps): update bundled SQLite and require Rust 1.89
- fix: fix(desktop): cap the whole popup at 85% of the display
- fix: fix(desktop): hide metrics with no data
- fix: fix(desktop): keep popup metric tiles at the design height
- fix: fix(desktop): name the Keychain in the macOS vault prompt
- fix: fix(desktop): preserve Linux launch path during updates
- fix: fix(desktop): refresh quota after granting vault access
- fix: fix(desktop): share the Swift app's vault on Developer ID builds
- change: build(desktop): sign macOS dev builds with Developer ID
- change: ci(desktop): publish signed Windows and Linux builds
- change: ci(desktop): run release build steps in bash on Windows
- change: docs(desktop): reconcile cutover contract with shared vault decision
- change: docs(desktop): record GPUI cutover contract and native evidence
- change: feat(desktop): add GPUI tray app for macOS, Linux and Windows (#568)
- change: feat(desktop): add proxy alerts and update card from the design
- change: feat(desktop): install, run and update CLIProxyAPI
- …and 7 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
nguyenphutrong/quotio was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 3ea984cf68a875299758afd56fa48ef850c649b1 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.