aiuse 2.1.10

What's new

• Shared quota-semantics v0.1 — docs/shared-quota-semantics/ (schemas, enums, pace formulas, golden fixtures) dogfooded in pytest
• Handoff / AGENTS priorities refreshed after product issues #2–#9 closed
• Includes everything from 2.1.9 (suggest, status/prompt, serve, forecast, History, health_path, local runtimes)

Install / upgrade

pipx upgrade aiuse
# or
brew upgrade aiuse

Verify

aiuse --version   # 2.1.10
aiuse doctor
.venv/bin/python -m pytest -q tests/test_shared_quota_semantics.py

aiuse 2.1.9

What's new

Product features from issues #2–#8 (since 2.1.8):

• aiuse suggest — single best burn pool (+ JSON suggestion)
• aiuse status / prompt — one-line status for shells (companion-stack.md)
• aiuse serve — loopback HTTP API for agents (agent-api.md)
• Louder forecast — ~lockout / ~N%waste on the priority ladder
• Deeper History — late-cycle leftovers, burn hints; JSON history
• health_path / probe_url — per-collector doctor preflight
• analysis.local_runtimes — optional Ollama/LM Studio note when cloud empty (off by default)
• Antigravity dual pools (Gemini vs Claude/GPT) already in 2.1.8

Install / upgrade

pipx upgrade aiuse
# or
brew upgrade aiuse

Verify

aiuse --version   # 2.1.9
aiuse suggest
aiuse status

aiuse 2.1.8

What's new

Antigravity dual pools — Google AI / Antigravity exposes two hard-separated budgets (Gemini vs Claude/GPT). aiuse now scores and lists each pool separately on the priority ladder instead of collapsing them into one shared-allotment window.

Docs: antigravity-pools.md (also clarifies Anthropic Claude Code via cswap vs Google-sold Claude/GPT).

Install / upgrade

pipx upgrade aiuse
# or
brew upgrade aiuse

Verify

aiuse --version   # 2.1.8
aiuse --no-tui -q | grep -i antigravity

aiuse 2.1.7

Summary

Personal CLI that ranks which AI subscription quotas you should burn before they reset (use-it-or-lose-it), not just another menu-bar % display.

Highlights

• Priority ladder (empty → n/a prepaid → slow → mid → use) for “what pool next?”
• Five data sources: cswap, CodexBar, caut, OpenUsage, tokscale (multi-source cross-checks)
• Pace burn/conserve scoring + shared allotment; prepaid (Deepseek, etc.) as non-urgent n/a
• packaging/install-deps.sh / just install-deps installs the external tools
• Claude multi-account via cswap; JSON contract + exit codes for scripts/cron

Install

pipx install aiuse
# or
brew tap djbclark/aiuse && brew trust djbclark/aiuse && brew install aiuse

./packaging/install-deps.sh   # external collectors (from a clone)
aiuse doctor
aiuse

Note

Much of this project is AI-assisted. If you avoid AI-generated code, this repo is probably not for you — no hard feelings.

aiuse 2.1.6

Summary

• Multi-source collectors: caut + OpenUsage enabled by default alongside cswap, CodexBar, and tokscale
• Generalized all-pairs cross-checks (easy to add more peers later)
• Selection priority unchanged in spirit: Claude→cswap, Copilot→tokscale, else CodexBar first
• Prepaid / non-expiring balances stay in the n/a ladder band (from 2.1.5)
• Docs: docs/collectors-caut-openusage.md, competitive landscape

Install / upgrade

pipx upgrade aiuse
# or
brew upgrade aiuse

Optional machine tools (for full cross-check coverage)

just -f ~/ops/site-djbclark/justfile install-ai-quota-tools
# OpenUsage: leave app running, or Settings → Command Line → Install

aiuse 2.1.5

Summary

• Prepaid / pay-as-you-go (Deepseek, OpenRouter, …): no use-or-lose urgency — purchased tokens do not expire
• New ladder tag n/a (dim) between empty and slow for non-expiring balances
• Balance inventory copy: balance $X.XX (no expiry) instead of fake 100% left · use before reset

Install

pipx upgrade aiuse
# or
brew upgrade aiuse

aiuse 2.1.4

Summary

• --full History section: snapshot span, learned burn rates, chronic underuse
• Action-plan / detail pace lines note when blended with history
• pace.learned_sample_count in JSON output

Install

pipx upgrade aiuse
# or
brew upgrade aiuse

aiuse 2.1.3

learn_from_history: auto (default) turns on learned pace/chronic signals once ≥ 2 snapshots exist. Set false to disable.

pipx upgrade aiuse

aiuse 2.1.2

Ship analysis.persist_snapshots for LaunchAgent / history accumulation without enabling learn_from_history.

Install

pipx upgrade aiuse

Operator rollout: cd ~/ops/site-djbclark && just site-agents-apply

aiuse 2.1.1

Verify PyPI Trusted Publishing (OIDC) via GitHub Actions.

Install

pipx upgrade aiuse
# or
pipx install aiuse

No functional CLI changes vs 2.1.0 — packaging/OIDC verification release.