QuotaFence is an open-source quota manager for AI coding agents. It tracks Codex and Claude Code allowances, assigns weekly budgets to local folders, and helps prevent lower-priority work from consuming quota intended for critical projects.
Weekly quota · priority 1 is protected first
QUOTAFENCE TOP live local control plane PROVIDER 5-HOUR WEEKLY Claude Code ━━━━━━── 62% ━━━━━━━━ 74% Codex ━━━━━━━━ 93% ━━━━━━━─ 85% # PROJECT WEEKLY USED LEFT STATUS 1 project-a 40% 15% 25% ● allow 2 project-b 25% 5% 20% ● allow refreshed just now · live interval 30s
The problem
Provider usage pages show account-level capacity. They do not give each local project an explicit weekly budget or priority when several agents share the same allowance.
The control layer
QuotaFence combines provider allowance tracking, weekly folder budgets, local policy checks, and basic history without requiring a hosted account.
See Codex and Claude Code 5-hour and weekly limits, reset times, sync health, and basic local usage history in one view.
Create, resize, remove, and reprioritize weekly project budgets from the desktop app or the interactive terminal UI.
qfence codexApply local Warn and Stop policies before a managed launch or a new prompt observed by a verified provider hook.
Why not just the provider dashboard
Without QuotaFence
With QuotaFence
The CLI
The same local ledger powers the desktop app and qfence. Monitor quota live, manage project budgets, and launch protected agents without changing context.
❯ qfence top --onceQUOTAFENCE TOP live local control plane interactive mode: qfence top ╭─────────────┬──────────────────────────────┬──────────────────────────────┬──────────────╮ │ PROVIDER │ 5-HOUR │ WEEKLY │ SYNCED │ ├─────────────┼──────────────────────────────┼──────────────────────────────┼──────────────┤ │ Claude Code │ ━━━━━━── 70% ↻ today 12:00 │ ━━━━━━━━ 90% ↻ tomorrow │ ● 55s ago │ │ Codex │ ━━━━━━━━ 93% ↻ today 16:22 │ ━━━━━━━─ 85% ↻ Sep 15 04:21 │ ● 7s ago │ ╰─────────────┴──────────────────────────────┴──────────────────────────────┴──────────────╯ PROJECT ALLOCATIONS ╭─────┬─────────────┬─────────────────────┬──────────┬──────────┬──────────┬──────────────╮ │ # │ PROVIDER │ PROJECT │ WEEKLY │ USED │ LEFT │ STATUS │ ├─────┼─────────────┼─────────────────────┼──────────┼──────────┼──────────┼──────────────┤ │ 1 │ Claude Code │ project-c │ 15% │ 2% │ 13% │ ● allow │ │ 1 │ Codex │ project-a │ 50% │ 12% │ 38% │ ● allow │ │ 2 │ Codex │ project-b │ 30% │ 6% │ 24% │ ● allow │ ╰─────┴─────────────┴─────────────────────┴──────────┴──────────┴──────────┴──────────────╯ ● Claude Code · 20% used over 30 days ··········▂···▄··············█ 10 Aug 08 Sep ● Codex · 35% used over 30 days ·▂▂█····▁·▂···▁···▁▁······▂·▁▂ 10 Aug 08 Sep refreshed just now · live interval 30s
❯ qfence allocations add --provider codex --percent 20PROJECT WEEKLY USED LEFT STATUS project-a 50% 12% 38% ● allow project-b 30% 6% 24% ● allow project-c 20% 0% 20% ● allow # Resize, fund from another project, or change priority ❯ qfence allocations set project-c --percent 30 --from project-a ❯ qfence allocations move project-c up
❯ qfence codexQuotaFence: launching Codex for project-a with 2 percentage points reserved (Weekly) # Claude uses the same admission and reconciliation flow ❯ qfence claude # Preview a decision without launching ❯ qfence admit codex
Sync the allowance windows returned by Codex or Claude Code.
Give each local project folder a weekly budget and priority.
Check the active policy before supported new work begins.
Reconcile provider movement and keep uncertain usage unattributed.
Install QuotaFence
Checking the latest release…
One command for supported macOS, Windows x64, and GNU/Linux x64 machines.
npm install -g @quotafence/cli
Installation guide →
Universal DMG for Apple Silicon and Intel. Signing status is listed with each release.
View releases ↗Unsigned x64 installer preview. Verify the published checksum before bypassing SmartScreen.
View releases ↗x64 AppImage for portable use, plus a Debian package for compatible distributions.
Desktop downloads come from GitHub Releases. CI artifacts are temporary build outputs and are not used by these buttons. Read the installation guide →
Frequently asked questions
QuotaFence is an open-source, local-first coding agent quota manager for Codex and Claude Code. It tracks provider allowance windows and lets you assign weekly budgets and priorities to local project folders.
No. QuotaFence does not intentionally collect or upload prompts, responses, source files, transcripts, provider credentials, or its local SQLite database.
No. Providers expose aggregate subscription usage, not exact subscription-token totals by folder. QuotaFence attributes supported managed activity and leaves ambiguous or concurrent activity explicitly unattributed.
Yes. Both providers support 5-hour and weekly allowance sync, weekly project budgets, managed CLI launches, and provider-specific desktop prompt integrations where available.
The current core is open source under Apache 2.0 and includes project allocations, local enforcement, basic history, and desktop and terminal dashboards without a project-count limit.
Built on trust
Your policy stays on your device. Workspace metadata, allocations, and the managed-session ledger use local storage. No hosted account is required.
Capability claims match reality. QuotaFence distinguishes process control, trusted prompt admission, and observation-only tracking instead of treating them as equivalent.
Uncertainty remains visible. Concurrent or unmapped activity stays unattributed instead of being assigned to the wrong project.
Open source · Apache 2.0
Track Codex and Claude Code in one local dashboard, then turn shared weekly allowance into explicit project budgets and priorities.