ccpace 0.1.0__tar.gz

ccpace-0.1.0/.gitignore

@@ -0,0 +1,3 @@
+__pycache__/
+*.pyc
+dist/

ccpace-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 thevibeworks
+
+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.

ccpace-0.1.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: ccpace
+Version: 0.1.0
+Summary: Pace your Claude quota: multi-account usage monitor with a countable 5h-window budget, weekday forecasts, and push notifications
+Project-URL: Homepage, https://thevibeworks.github.io/ccpace/
+Project-URL: Repository, https://github.com/thevibeworks/ccpace
+Project-URL: Changelog, https://github.com/thevibeworks/ccpace/blob/main/CHANGELOG.md
+Author: thevibeworks
+License: MIT
+License-File: LICENSE
+Keywords: claude,claude-code,monitor,quota,rate-limit,usage
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: httpx[socks]
+Description-Content-Type: text/markdown
+
+# ccpace
+
+Pace your Claude quota. Multi-account usage monitor for Claude
+subscriptions: real utilization from the official usage endpoint — not
+estimates from transcripts — a countable 5h-window budget, weekday
+forecasts learned from your own history, and push notifications.
+
+```
+── [20x] work · period ends ~Aug 11 ────────────────────────────────
+5h     7% █▒░░░░░░░░  3h 48m   @19:00              0.3x
+7d     3% █░░░░░░░░░  6d 8h    @Thu 13 00:00       0.3x
+fable  3% █░░░░░░░░░  6d 8h    @Thu 13 00:00       0.3x
+           ··▁▮▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫┤
+           budget: ~24 windows left · 4.0%/window stays even · period ends ~Aug 11
+           forecast: +38% rest of week on your pattern · lands ~41% (12d history)
+```
+
+## Install
+
+```sh
+uvx ccpace                 # one glance, all discovered accounts
+uvx ccpace --watch         # live TUI: r=refresh, q=quit
+```
+
+Or grab the single file — it is the whole tool:
+
+```sh
+curl -fsSLO https://raw.githubusercontent.com/thevibeworks/ccpace/main/ccpace.py
+uv run --script ccpace.py
+```
+
+As a Claude Code plugin (`/ccpace` inside Claude Code):
+
+```
+/plugin marketplace add thevibeworks/ccpace
+/plugin install ccpace@ccpace
+```
+
+Requires [uv](https://docs.astral.sh/uv/) and a Claude subscription
+you are logged into (`claude login`); credentials are discovered from
+`~/.claude/.credentials*.json`. Multiple credential files = fleet view,
+sorted by tier.
+
+## What it shows
+
+- One block per account: 5h window, 7d window, per-model caps, extra
+  usage spend, prepaid credit balance when nonzero.
+- Dual bars merge usage with window-elapsed time: `█` both passed, `▓`
+  usage ahead (hot), `▒` time ahead (headroom), `░` untouched.
+- The window ledger: the 7d period as its 5h windows, one cell each.
+  `▁▂▃▄▅▆▇█` what a window burned (from your sample history), `·` idle,
+  `░` unknown, `▮` now, `▫` ahead, `×` won't be covered at current pace,
+  `┤` access ends there. Cells right of `▮` are countable — they equal
+  the advisor's "windows left".
+- The advisor: pace warnings (`!`), budget per remaining window, and a
+  weekday forecast once it has 3+ days of your history.
+- Budget math truncates at the subscription period end (derived from
+  the billing anniversary — the API exposes no cancel/renew date, so
+  the boundary is assumed and marked with `~`).
+
+## Notifications
+
+System notifications (macOS/Linux) fire on threshold, quota-full,
+pace, and reset events. Add push channels:
+
+```sh
+ccpace --watch --ntfy https://ntfy.sh/your-topic
+ccpace --watch --bark https://api.day.app/YOUR_KEY
+ccpace --watch --notifier ~/bin/my-hook.sh   # JSON on stdin
+```
+
+Env: `CCPACE_NTFY`, `CCPACE_BARK`, `CCPACE_NOTIFIER`, `CCPACE_INTERVAL`,
+`CCPACE_THRESHOLD`, `CCPACE_TZ` (e.g. `America/New_York,Asia/Tokyo`).
+
+## Data
+
+Samples append to a shared store compatible with
+[claude-code-statusline](https://github.com/thevibeworks/claude-code-statusline)
+(`~/.claude/statusline/accounts/<alias>/usage.jsonl`): both tools feed
+one history, so the ledger and forecasts get richer whichever tool you
+run. Contract in [docs/data.md](docs/data.md). `--no-log` disables
+writing; `CCPACE_DATA_DIR` relocates the store.
+
+## Honest caveats
+
+- Uses the same undocumented OAuth endpoints as the Claude Code CLI,
+  read-only, against your own account. Anthropic can change or gate
+  them at any release; expect breakage, report it, don't build a
+  business on it.
+- One deliberate write: expired tokens are refreshed via the official
+  OAuth flow and written back to the credentials file — the same thing
+  Claude Code does on your behalf.
+- Polling is deliberately polite: 15 min default interval with jitter,
+  minimum 60 s, exponential backoff on errors, no polling of accounts
+  pinned at 100%.
+- Forecasts are your own history extrapolated, not a promise. Below 3
+  days of samples the forecast stays silent instead of guessing.
+- Not affiliated with Anthropic.
+
+## License
+
+MIT

ccpace-0.1.0/README.md

@@ -0,0 +1,102 @@
+# ccpace
+
+Pace your Claude quota. Multi-account usage monitor for Claude
+subscriptions: real utilization from the official usage endpoint — not
+estimates from transcripts — a countable 5h-window budget, weekday
+forecasts learned from your own history, and push notifications.
+
+```
+── [20x] work · period ends ~Aug 11 ────────────────────────────────
+5h     7% █▒░░░░░░░░  3h 48m   @19:00              0.3x
+7d     3% █░░░░░░░░░  6d 8h    @Thu 13 00:00       0.3x
+fable  3% █░░░░░░░░░  6d 8h    @Thu 13 00:00       0.3x
+           ··▁▮▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫▫┤
+           budget: ~24 windows left · 4.0%/window stays even · period ends ~Aug 11
+           forecast: +38% rest of week on your pattern · lands ~41% (12d history)
+```
+
+## Install
+
+```sh
+uvx ccpace                 # one glance, all discovered accounts
+uvx ccpace --watch         # live TUI: r=refresh, q=quit
+```
+
+Or grab the single file — it is the whole tool:
+
+```sh
+curl -fsSLO https://raw.githubusercontent.com/thevibeworks/ccpace/main/ccpace.py
+uv run --script ccpace.py
+```
+
+As a Claude Code plugin (`/ccpace` inside Claude Code):
+
+```
+/plugin marketplace add thevibeworks/ccpace
+/plugin install ccpace@ccpace
+```
+
+Requires [uv](https://docs.astral.sh/uv/) and a Claude subscription
+you are logged into (`claude login`); credentials are discovered from
+`~/.claude/.credentials*.json`. Multiple credential files = fleet view,
+sorted by tier.
+
+## What it shows
+
+- One block per account: 5h window, 7d window, per-model caps, extra
+  usage spend, prepaid credit balance when nonzero.
+- Dual bars merge usage with window-elapsed time: `█` both passed, `▓`
+  usage ahead (hot), `▒` time ahead (headroom), `░` untouched.
+- The window ledger: the 7d period as its 5h windows, one cell each.
+  `▁▂▃▄▅▆▇█` what a window burned (from your sample history), `·` idle,
+  `░` unknown, `▮` now, `▫` ahead, `×` won't be covered at current pace,
+  `┤` access ends there. Cells right of `▮` are countable — they equal
+  the advisor's "windows left".
+- The advisor: pace warnings (`!`), budget per remaining window, and a
+  weekday forecast once it has 3+ days of your history.
+- Budget math truncates at the subscription period end (derived from
+  the billing anniversary — the API exposes no cancel/renew date, so
+  the boundary is assumed and marked with `~`).
+
+## Notifications
+
+System notifications (macOS/Linux) fire on threshold, quota-full,
+pace, and reset events. Add push channels:
+
+```sh
+ccpace --watch --ntfy https://ntfy.sh/your-topic
+ccpace --watch --bark https://api.day.app/YOUR_KEY
+ccpace --watch --notifier ~/bin/my-hook.sh   # JSON on stdin
+```
+
+Env: `CCPACE_NTFY`, `CCPACE_BARK`, `CCPACE_NOTIFIER`, `CCPACE_INTERVAL`,
+`CCPACE_THRESHOLD`, `CCPACE_TZ` (e.g. `America/New_York,Asia/Tokyo`).
+
+## Data
+
+Samples append to a shared store compatible with
+[claude-code-statusline](https://github.com/thevibeworks/claude-code-statusline)
+(`~/.claude/statusline/accounts/<alias>/usage.jsonl`): both tools feed
+one history, so the ledger and forecasts get richer whichever tool you
+run. Contract in [docs/data.md](docs/data.md). `--no-log` disables
+writing; `CCPACE_DATA_DIR` relocates the store.
+
+## Honest caveats
+
+- Uses the same undocumented OAuth endpoints as the Claude Code CLI,
+  read-only, against your own account. Anthropic can change or gate
+  them at any release; expect breakage, report it, don't build a
+  business on it.
+- One deliberate write: expired tokens are refreshed via the official
+  OAuth flow and written back to the credentials file — the same thing
+  Claude Code does on your behalf.
+- Polling is deliberately polite: 15 min default interval with jitter,
+  minimum 60 s, exponential backoff on errors, no polling of accounts
+  pinned at 100%.
+- Forecasts are your own history extrapolated, not a promise. Below 3
+  days of samples the forecast stays silent instead of guessing.
+- Not affiliated with Anthropic.
+
+## License
+
+MIT