agent-usage-all-in-one 0.2.1

package/BUNDLED_DEPENDENCIES.json

@@ -0,0 +1,9 @@
+{
+  "packages": [
+    "@sveltejs/kit",
+    "clsx",
+    "devalue",
+    "esm-env",
+    "svelte"
+  ]
+}

package/BUNDLED_LICENSES.md

@@ -0,0 +1,76 @@
+# Bundled dependency license texts
+
+The following dependency code is bundled into the browser distribution shipped by this package.
+This file is generated by `pnpm licenses:generate` from the locked dependency graph.
+
+## @sveltejs/kit 2.70.3
+
+Declared license: MIT
+
+```text
+Copyright (c) 2020 [these people](https://github.com/sveltejs/kit/graphs/contributors)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+## clsx 2.1.1
+
+Declared license: MIT
+
+```text
+MIT License
+
+Copyright (c) Luke Edwards <luke.edwards05@gmail.com> (lukeed.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+## devalue 5.9.2
+
+Declared license: MIT
+
+```text
+Copyright (c) 2018-19 [these people](https://github.com/rich-harris/devalue/graphs/contributors)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+## esm-env 1.2.2
+
+Declared license: MIT
+
+```text
+Copyright 2022 Benjamin McCann
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+## svelte 5.56.10
+
+Declared license: MIT
+
+```text
+Copyright (c) 2016-2025 [Svelte Contributors](https://github.com/sveltejs/svelte/graphs/contributors)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,11 @@
+# Community code of conduct
+
+Be respectful, specific, and constructive. Harassment, discrimination, threats,
+doxxing, and publishing another person's private usage data or credentials are
+not accepted in project spaces. Discuss technical decisions with evidence and
+criticize the work rather than the person.
+
+Maintainers may edit or remove harmful content and restrict participation when
+needed to protect the community. Report conduct concerns through GitHub's
+content-reporting tools; for private security-related conduct, use the private
+vulnerability form linked in `SECURITY.md`.

package/CONTRIBUTING.md

@@ -0,0 +1,41 @@
+# Contributing
+
+Thank you for improving Agent Usage. The project is local-first and handles
+sensitive developer activity, so data authority, privacy, and non-overlapping
+accounting are release requirements rather than optional polish.
+
+## Development
+
+Use macOS, Node.js 24+, and pnpm 10.33.3.
+
+```bash
+pnpm install
+pnpm dev
+```
+
+Before opening a pull request, run:
+
+```bash
+pnpm format:check
+pnpm lint
+pnpm check
+pnpm test
+pnpm build
+pnpm test:package
+pnpm test:e2e
+```
+
+Add a changeset for every user-visible change with `pnpm changeset`. Tests must
+use synthetic fixtures and temporary homes; never commit transcripts, account
+identifiers, tokens, cookies, API keys, or local database contents.
+
+## Issues and pull requests
+
+Use GitHub Issues for new public work. Historical specifications and tickets in
+`.scratch/` keep their stable local identifiers. Describe the observed behavior,
+expected behavior, reproduction, affected Provider/billing domain, and whether
+the evidence is account-wide or this-Mac.
+
+Pull requests should be narrowly scoped, link the issue, explain authority and
+cost-purpose decisions, and include verification evidence. Provider trademarks
+must follow the audited asset rules in `static/brands/README.md`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agent Usage contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,144 @@
+![Agent Usage banner](static/brand/agent-usage-banner.svg)
+
+# Agent Usage
+
+[English](README.md) · [简体中文](README.zh-CN.md)
+
+[![CI](https://github.com/Blackman99/agent-usage-all-in-one/actions/workflows/ci.yml/badge.svg)](https://github.com/Blackman99/agent-usage-all-in-one/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/agent-usage-all-in-one.svg)](https://www.npmjs.com/package/agent-usage-all-in-one)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Agent Usage is a macOS-first, fully local usage center for Codex, Claude Code,
+OpenCode Go, and Grok. One command opens a dashboard for native quota windows,
+reset times, tokens, model rankings, equivalent API cost, history, and diagnostics.
+It offers advice but never switches agents automatically.
+
+## Dashboard
+
+The dashboard has two primary tabs:
+
+- **Agent usage** preserves each provider's native five-hour, weekly, monthly,
+  All models, and Fable-only quota labels and reset times.
+- **Tokens & model costs** supports 24-hour, 7-day, and 30-day ranges. It shows
+  token categories, provider totals, daily trends, model rankings, and the public
+  API retail equivalent of eligible token usage.
+
+Actual charges, provider-reported estimates, fixed subscription fees, and API
+retail equivalents are separate evidence. The API retail equivalent is not a bill
+and is never presented as subscription spend. Unknown models or prices remain
+unclassified or unpriced instead of being guessed or displayed as zero.
+
+Grok Build/SuperGrok and xAI API are independent billing domains. Their quotas,
+tokens, and costs are never added together.
+
+## Fast, progressive startup
+
+The loopback web service starts before connector discovery or data processing.
+Cached results are available immediately while discovery, provider usage, model
+pricing, and retention run as independent background modules. Each dashboard tab
+shows only its own update indicator and completed sections remain usable.
+
+Transcript scans use a persistent, path-redacted file index. Historical retail
+pricing is recalculated only when the pricing catalog version changes. SQLite
+time/provider/model indexes and retention compaction run in a worker after
+provider collection, while price backfill processes bounded pages. Settings
+includes an explicitly confirmed
+**Hard rebuild all data** action for troubleshooting. It ignores these caches, can
+use substantial resources, and may take a long time without blocking the web UI.
+
+## Development
+
+```bash
+pnpm install
+pnpm dev
+```
+
+This starts the source daemon, authenticated Vite proxy, hot reload, and dashboard.
+Development state is isolated in the ignored `.agent-usage-dev/` directory. Use
+`AGENT_USAGE_DEMO=1 pnpm dev` for demo data or `pnpm dev -- --no-open` to keep the
+browser closed.
+
+## Install and run
+
+Agent Usage requires macOS and Node.js 24 or newer.
+
+```bash
+npm install --global agent-usage-all-in-one
+agent-usage
+```
+
+To build and install a package from source:
+
+```bash
+pnpm install
+pnpm build
+archive=$(pnpm pack)
+npm install --global "./$archive"
+agent-usage
+```
+
+The daemon binds only to `127.0.0.1`. Application data is stored under
+`~/Library/Application Support/Agent Usage` by default.
+
+Common commands:
+
+```bash
+agent-usage status --window 7d
+agent-usage doctor
+agent-usage export --format json --window 30d
+agent-usage export --format csv --window 7d
+agent-usage retention --json
+agent-usage retention --compact
+agent-usage monitoring --json
+agent-usage start-at-login enable
+agent-usage clear --yes
+```
+
+## Provider coverage
+
+| Provider / billing domain | Native quota                                                            | Token history                                       | Cost evidence                                                                          |
+| ------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| Codex                     | Official account buckets when available                                 | Local rollouts with account-day reconciliation      | API retail equivalent                                                                  |
+| Claude Code               | Experimental official-client usage, including All models and Fable only | Local session transcripts; optional OTLP supplement | Client estimate and API retail equivalent                                              |
+| OpenCode Go               | Official account-wide five-hour, weekly, and monthly windows            | Official CLI/session export                         | Provider-reported or explicitly estimated values                                       |
+| Grok Build / SuperGrok    | Experimental shared subscription allowance                              | Local `updates.jsonl`; optional OTLP supplement     | Client estimate and API retail equivalent, including recognized Grok 4.6 Build aliases |
+| Grok · xAI API            | No subscription quota                                                   | Official Management API aggregation                 | Actual USD amounts, balance, limit, and invoice when available                         |
+
+Every value retains its authority and observation time. Account-wide and this-Mac
+evidence remain visibly distinct.
+
+## Credentials and privacy
+
+Official-client credentials stay in their owning clients and are neither copied
+nor displayed. The optional xAI Management key is the only product-owned secret;
+it is stored in macOS Keychain. The dashboard uses a one-time launch token,
+HttpOnly session cookie, and same-origin mutation protection.
+
+All usage data remains local. JSON and CSV exports omit account identifiers,
+session IDs, cookies, OAuth tokens, and secret values by default. Raw observations
+are retained for 90 days, then transactionally compacted into UTC daily aggregates.
+Clearing local usage never deletes credentials owned by Codex, Claude Code,
+OpenCode, or Grok.
+
+## Verification
+
+```bash
+pnpm format:check
+pnpm lint
+pnpm check
+pnpm test
+pnpm build
+pnpm test:package
+pnpm test:e2e
+```
+
+See the [official pricing evidence](docs/research/official-pricing-sources-2026-08-28.md),
+[connector receipts](docs/release/connector-receipts-2026-08-28.md), and
+[open-source notices](docs/open-source.md).
+
+## License and community
+
+MIT — see [LICENSE](LICENSE). Also see [CONTRIBUTING.md](CONTRIBUTING.md),
+[SECURITY.md](SECURITY.md), [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md),
+[THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md), and
+[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).

package/README.zh-CN.md

@@ -0,0 +1,128 @@
+![Agent Usage 横幅](static/brand/agent-usage-banner.svg)
+
+# Agent Usage
+
+[English](README.md) · [简体中文](README.zh-CN.md)
+
+[![CI](https://github.com/Blackman99/agent-usage-all-in-one/actions/workflows/ci.yml/badge.svg)](https://github.com/Blackman99/agent-usage-all-in-one/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/agent-usage-all-in-one.svg)](https://www.npmjs.com/package/agent-usage-all-in-one)
+[![许可证：MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Agent Usage 是一个 macOS 优先、完全在本地运行的用量中心。一次启动即可统一查看
+Codex、Claude Code、OpenCode Go 与 Grok 的原生额度窗口、刷新时间、Token、模型排行、
+API 对等费用、历史与诊断。它只提供建议，不会自动切换 Agent。
+
+## 核心页面
+
+页面只有两个主要标签页：
+
+- **Agent 用量**：保留各平台原生的 5 小时、周、月、All models 和 Fable only 等额度标签与刷新时间。
+- **Token 与模型费用**：支持 24 小时、7 天和 30 天范围，展示 Token 分类、平台汇总、每日趋势、模型排行，以及符合条件的 Token 按公开 API 价格计算出的对等费用。
+
+实际账单、平台报告估算、固定订阅费和 API 对等零售价是四类互不混合的证据。
+API 对等零售价不是账单，也不会被描述成订阅支出。模型或价格未知时保持未分类或未定价，
+不会猜测，更不会显示成 0。
+
+Grok Build/SuperGrok 与 xAI API 是两个独立计费域，其额度、Token 和费用永远不会相加。
+
+## 快速渐进式启动
+
+本地 Web 服务会先启动，再在后台运行连接发现、平台用量、模型定价和保留整理四个独立模块。
+已有缓存会立即展示；每个标签页只在自己的数据区域显示更新状态，已经完成的内容始终可用。
+
+本地会话记录扫描使用跨进程持久化且不保存原始个人路径的文件索引。历史费用只在价格目录版本变化时
+重新计算，并按有限批次处理；时间、平台、模型和计费域索引及保留期整理会在平台采集完成后交给后台
+工作线程执行。设置里提供需要明确确认的
+**硬重算全部数据**：它会忽略缓存、消耗较多资源，并且可能等待很久，但不会阻塞页面。
+
+## 开发调试
+
+```bash
+pnpm install
+pnpm dev
+```
+
+该命令会启动源码守护进程、带认证的 Vite 代理、热更新和页面。开发数据隔离在已忽略的
+`.agent-usage-dev/` 目录。使用 `AGENT_USAGE_DEMO=1 pnpm dev` 加载演示数据；使用
+`pnpm dev -- --no-open` 禁止自动打开浏览器。
+
+## 安装与启动
+
+要求 macOS 和 Node.js 24 或更高版本。
+
+```bash
+npm install --global agent-usage-all-in-one
+agent-usage
+```
+
+从源码构建并安装：
+
+```bash
+pnpm install
+pnpm build
+archive=$(pnpm pack)
+npm install --global "./$archive"
+agent-usage
+```
+
+守护进程只绑定 `127.0.0.1`。应用数据默认保存在
+`~/Library/Application Support/Agent Usage`。
+
+常用命令：
+
+```bash
+agent-usage status --window 7d
+agent-usage doctor
+agent-usage export --format json --window 30d
+agent-usage export --format csv --window 7d
+agent-usage retention --json
+agent-usage retention --compact
+agent-usage monitoring --json
+agent-usage start-at-login enable
+agent-usage clear --yes
+```
+
+## 平台覆盖范围
+
+| 平台 / 计费域          | 原生额度                                            | Token 历史                           | 费用证据                                                      |
+| ---------------------- | --------------------------------------------------- | ------------------------------------ | ------------------------------------------------------------- |
+| Codex                  | 可用时读取官方账户额度桶                            | 本地 rollout，并与账户日汇总对账     | API 对等零售价                                                |
+| Claude Code            | 实验性官方客户端用量，包括 All models 与 Fable only | 本地会话记录；可选 OTLP 补充         | 客户端估算与 API 对等零售价                                   |
+| OpenCode Go            | 官方账户级 5 小时、周、月窗口                       | 官方命令行或会话导出                 | 平台报告值或明确标注的估算                                    |
+| Grok Build / SuperGrok | 实验性共享订阅额度                                  | 本地 `updates.jsonl`；可选 OTLP 补充 | 客户端估算与 API 对等零售价，包括可识别的 Grok 4.6 Build 别名 |
+| Grok · xAI API         | 没有订阅额度                                        | 官方 Management API 聚合             | 可用时展示实际美元金额、余额、上限与账单                      |
+
+每个数字都会保留来源权威等级和观测时间；账户全局与仅此 Mac 的证据始终明确区分。
+
+## 凭据与隐私
+
+官方客户端凭据始终留在原客户端中，不复制、不回显。可选的 xAI Management 密钥是唯一由
+Agent Usage 管理的凭据，存储在 macOS 钥匙串。本地页面使用一次性启动令牌、HttpOnly
+会话 Cookie 和同源写操作保护。
+
+所有用量数据都留在本机。JSON/CSV 导出默认排除账户标识、会话 ID、Cookie、OAuth Token
+和密钥值。原始观测保留 90 天，之后在事务中压缩为 UTC 日汇总。清理本地用量永远不会删除
+Codex、Claude Code、OpenCode 或 Grok 官方客户端拥有的凭据。
+
+## 验证
+
+```bash
+pnpm format:check
+pnpm lint
+pnpm check
+pnpm test
+pnpm build
+pnpm test:package
+pnpm test:e2e
+```
+
+可查阅[官方定价证据](docs/research/official-pricing-sources-2026-08-28.md)、
+[连接验证收据](docs/release/connector-receipts-2026-08-28.md)与
+[开源说明](docs/open-source.md)。
+
+## 许可证与社区
+
+MIT，详见 [LICENSE](LICENSE)。另请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)、
+[SECURITY.md](SECURITY.md)、[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)、
+[THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md) 和
+[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

package/SECURITY.md

@@ -0,0 +1,26 @@
+# Security policy
+
+## Supported versions
+
+Security fixes are provided for the latest published version.
+
+## Reporting a vulnerability
+
+Do not open a public issue for credential exposure, local-auth bypass, unsafe
+file access, or privacy leaks. Use the repository's **Security → Report a
+vulnerability** private form at
+`https://github.com/Blackman99/agent-usage-all-in-one/security/advisories/new`.
+Include the affected version, impact, reproduction, and a
+minimal synthetic proof of concept. Never attach real agent transcripts,
+credentials, account identifiers, or the Agent Usage SQLite database.
+
+If the private form is unavailable, open a GitHub issue containing no sensitive
+details and ask a maintainer to establish a private channel. The maintainers
+will acknowledge a complete report as soon as practical,
+coordinate remediation privately, and credit reporters who request attribution.
+
+## Security boundary
+
+Agent Usage binds its daemon to loopback, uses launch-token authentication, and
+reads supported clients' local files and credentials without copying secrets into
+its database. A vulnerability that crosses those boundaries is in scope.