Weekly usage guard for Claude Code and Codex that blocks the next tool call once a set limit is crossed, with resume anytime.
Peras overview
1 / 2Overview
What is Peras?
Pause Claude Code and Codex before they burn your week
Peras puts a line in your Claude Code and Codex week. Set it, for example with peras set weekly 85 pause, and once usage crosses it, the agent's next tool call is refused with a plain reason, so one long task cannot burn the rest of your week.
You can resume whenever you want, from the terminal or the menu bar, and optionally let your agents be told their own usage. The CLI and hooks are free and MIT, while the native Mac menu bar app costs €4.99 once.
Platforms and languages
Peras Availability
Platforms
Languages
Capabilities
Peras Key Features
Weekly usage line
Set a weekly line, for example with peras set weekly 85 pause, for Claude Code and Codex.
Automatic pause at the limit
Once usage crosses the line, the agent's next tool call is refused with a plain reason.
Resume anytime
Resume whenever you want, from the terminal or the Mac menu bar app.
Opt-in usage awareness
Optionally, your agents can be told their own usage.
Free CLI, paid Mac app
The CLI and hooks are free and MIT; the native Mac menu bar app is a one-time purchase.
Best for
Who uses Peras?
Developers running Claude Code and Codex through a weekly usage allowance
Stop one long task from burning the rest of the week's allowance, then resume on demand
Plans and access
Peras Pricing
Freemium
CLI and hooks free (MIT); native Mac menu bar app €4.99 one-time.
Common questions
Peras FAQs
What happens when I hit my weekly limit?
The agent's next tool call is refused with a plain reason, so the task pauses instead of burning the rest of your week.
Can I resume after a pause?
Yes, whenever you want, from the terminal or the menu bar app.
Is Peras free?
The CLI and hooks are free and MIT; the native Mac menu bar app is €4.99 once.
Which agents does Peras guard?
Claude Code and Codex, according to the launch description.
Reviews
See what the community thinks and share your experience.
—
Based on 0 ratings
Rating distribution
Community reviews
No reviews
No written reviews yet.
