Documentation
¶
Overview ¶
Quosparr is a menu-bar / system-tray monitor for local Codex quota, reset credits and API-equivalent cost.
Directories
¶
| Path | Synopsis |
|---|---|
|
Scripts
|
|
|
gen-glyphs
command
Command gen-glyphs writes internal/app/glyphs_gen.go: the interface icons, taken from Remix Icon (https://remixicon.com, Remix Icon License v1.0), and copies the provider SVGs from LobeHub Icons (https://icons.lobehub.com, MIT) into internal/app/assets/providers.
|
Command gen-glyphs writes internal/app/glyphs_gen.go: the interface icons, taken from Remix Icon (https://remixicon.com, Remix Icon License v1.0), and copies the provider SVGs from LobeHub Icons (https://icons.lobehub.com, MIT) into internal/app/assets/providers. |
|
release-assets
command
release-assets signs final, post-processed archives using mygo v0.7.4's Ed25519-over-SHA256 protocol, and writes the Sparkle feed of the Swift releases; private keys are read only from the environment.
|
release-assets signs final, post-processed archives using mygo v0.7.4's Ed25519-over-SHA256 protocol, and writes the Sparkle feed of the Swift releases; private keys are read only from the environment. |
|
verify-sqlite
command
verify-sqlite exercises only the explicitly named packaged runtime, in memory.
|
verify-sqlite exercises only the explicitly named packaged runtime, in memory. |
|
internal
|
|
|
alerts
Package alerts decides which quota, reset-credit and rate-limit-reset notifications are new.
|
Package alerts decides which quota, reset-credit and rate-limit-reset notifications are new. |
|
apiquota
Package apiquota queries the balance and the model list of third-party API relay sites from a base URL and an API key.
|
Package apiquota queries the balance and the model list of third-party API relay sites from a base URL and an API key. |
|
app
Package app is the Quosparr host: tray icon, panel and the startup sequence.
|
Package app is the Quosparr host: tray icon, panel and the startup sequence. |
|
cachehit
Package cachehit contains provider-neutral cache-hit summaries.
|
Package cachehit contains provider-neutral cache-hit summaries. |
|
claude
Package claude reads Claude Code subscription credentials, usage and local session logs for Quosparr.
|
Package claude reads Claude Code subscription credentials, usage and local session logs for Quosparr. |
|
codex
Package codex reads and writes Codex credentials and Quosparr's managed multi-account library.
|
Package codex reads and writes Codex credentials and Quosparr's managed multi-account library. |
|
codexapi
Package codexapi talks to the ChatGPT/Codex backend: quota and reset credit requests, the OAuth refresh and login (PKCE) exchanges, and the models they return.
|
Package codexapi talks to the ChatGPT/Codex backend: quota and reset credit requests, the OAuth refresh and login (PKCE) exchanges, and the models they return. |
|
codexdesktop
Package codexdesktop shares the local projects of the ChatGPT desktop app (bundle com.openai.codex) between the accounts Quosparr switches.
|
Package codexdesktop shares the local projects of the ChatGPT desktop app (bundle com.openai.codex) between the accounts Quosparr switches. |
|
codexruntime
Package codexruntime inspects an existing managed Codex daemon without refreshing credentials.
|
Package codexruntime inspects an existing managed Codex daemon without refreshing credentials. |
|
estimate
Package estimate ports QuotaEstimate.swift, QuotaEstimateAvailability.swift and QuotaEstimateHistoryStore.swift: how many Credits a full quota window is worth, extrapolated from the Credits used so far in the current cycle.
|
Package estimate ports QuotaEstimate.swift, QuotaEstimateAvailability.swift and QuotaEstimateHistoryStore.swift: how many Credits a full quota window is worth, extrapolated from the Credits used so far in the current cycle. |
|
export
Package export writes the files other programs read: the status JSON for scripts (status.json), the widget snapshot for the WidgetKit extension (widget-snapshot.json) and the widget's deep-link and layout contract.
|
Package export writes the files other programs read: the status JSON for scripts (status.json), the widget snapshot for the WidgetKit extension (widget-snapshot.json) and the widget's deep-link and layout contract. |
|
export/swiftjson
Package swiftjson writes JSON that is byte-identical to what the Swift app's JSONEncoder produced for the shared on-disk files (status.json, widget-snapshot.json, alerts.json, quota-estimate-history.json, reaction-visitor.json), and reads the numbers and dates it wrote.
|
Package swiftjson writes JSON that is byte-identical to what the Swift app's JSONEncoder produced for the shared on-disk files (status.json, widget-snapshot.json, alerts.json, quota-estimate-history.json, reaction-visitor.json), and reads the numbers and dates it wrote. |
|
grok
Package grok manages the Grok accounts of Quosparr: parsing the Grok CLI credential file, the managed multi-account library, import and export, the OAuth login and token refresh.
|
Package grok manages the Grok accounts of Quosparr: parsing the Grok CLI credential file, the managed multi-account library, import and export, the OAuth login and token refresh. |
|
l10n
Package l10n ports Quosparr's Swift localization layer: the translation tables, system-language resolution and Swift-style format strings.
|
Package l10n ports Quosparr's Swift localization layer: the translation tables, system-language resolution and Swift-style format strings. |
|
mcp
Package mcp manages user-scoped MCP declarations and explicitly requested connection previews without exposing credentials in summaries or errors.
|
Package mcp manages user-scoped MCP declarations and explicitly requested connection previews without exposing credentials in summaries or errors. |
|
migration
Package migration performs the one-time, non-destructive brand migration.
|
Package migration performs the one-time, non-destructive brand migration. |
|
netx
Package netx builds the explicit HTTP clients Quosparr uses for every network request.
|
Package netx builds the explicit HTTP clients Quosparr uses for every network request. |
|
platform
Package platform holds the small operating-system boundaries of Quosparr: the single-instance lock and the app-owned directory.
|
Package platform holds the small operating-system boundaries of Quosparr: the single-instance lock and the app-owned directory. |
|
pricing
Package pricing stores public model prices, independently of usage logs.
|
Package pricing stores public model prices, independently of usage logs. |
|
resettoday
Package resettoday is the Go port of Quosparr's "did Codex reset today" feature: the hosted status feed (RateLimitResetToday*.swift), its strict decoder, the verdict and next-scheduled-reset rules, the optional reaction service, and the controllers that poll and refresh them.
|
Package resettoday is the Go port of Quosparr's "did Codex reset today" feature: the hosted status feed (RateLimitResetToday*.swift), its strict decoder, the verdict and next-scheduled-reset rules, the optional reaction service, and the controllers that poll and refresh them. |
|
resettoday/runwayfmt
Package runwayfmt adapts internal/runway's duration and schedule formatting to the resettoday.Formatter the detail copy needs.
|
Package runwayfmt adapts internal/runway's duration and schedule formatting to the resettoday.Formatter the detail copy needs. |
|
runway
Package runway is the Codex-side application coordinator.
|
Package runway is the Codex-side application coordinator. |
|
sessions
Package sessions reads the Codex session files under ~/.codex for the recent sessions list (Scanner) and diagnoses or repairs ~/.codex/session_index.jsonl (Repairer).
|
Package sessions reads the Codex session files under ~/.codex for the recent sessions list (Scanner) and diagnoses or repairs ~/.codex/session_index.jsonl (Repairer). |
|
skills
Package skills discovers the global Agent Skills each CLI loads (Codex, Claude Code, Grok), reports whether the CLI would use them, and removes a user-owned skill into Quosparr's restorable trash (~/.quosparr/skills-trash).
|
Package skills discovers the global Agent Skills each CLI loads (Codex, Claude Code, Grok), reports whether the CLI would use them, and removes a user-owned skill into Quosparr's restorable trash (~/.quosparr/skills-trash). |
|
speed
Package speed measures how fast the models answer, from timestamps the official CLIs already write into their local session logs: the time to the first token of each model call and the output tokens per second while it streams.
|
Package speed measures how fast the models answer, from timestamps the official CLIs already write into their local session logs: the time to the first token of each model call and the output tokens per second while it streams. |
|
sqliteruntime
Package sqliteruntime owns SQLite runtime preparation and loading.
|
Package sqliteruntime owns SQLite runtime preparation and loading. |
|
sqliteruntime/assets/amd64
Package amd64 holds the pinned Windows x64 SQLite runtime from mygo v0.7.4.
|
Package amd64 holds the pinned Windows x64 SQLite runtime from mygo v0.7.4. |
|
sqliteruntime/assets/arm64
Package arm64 holds the pinned Windows ARM64 SQLite runtime from mygo v0.7.4.
|
Package arm64 holds the pinned Windows ARM64 SQLite runtime from mygo v0.7.4. |
|
store
Package store is the compatibility layer for Quosparr's user preferences and network proxy settings.
|
Package store is the compatibility layer for Quosparr's user preferences and network proxy settings. |
|
tomlstmt
Package tomlstmt finds and edits complete TOML statements while preserving all bytes outside the requested ranges.
|
Package tomlstmt finds and edits complete TOML statements while preserving all bytes outside the requested ranges. |
|
usage
Package usage reads Codex session logs and turns them into API-equivalent cost summaries.
|
Package usage reads Codex session logs and turns them into API-equivalent cost summaries. |
|
usage/decimal
Package decimal is a small exact decimal type that follows the arithmetic and text rules of Foundation's Decimal for the operations the usage cost code needs: construction from integers and text, addition, multiplication, division, comparison, and JSON numbers.
|
Package decimal is a small exact decimal type that follows the arithmetic and text rules of Foundation's Decimal for the operations the usage cost code needs: construction from integers and text, addition, multiplication, division, comparison, and JSON numbers. |
|
website
|
|
|
gen
command
Command gen renders the static quosparr.com site.
|
Command gen renders the static quosparr.com site. |
Click to show internal directories.
Click to hide internal directories.





