Peras

Peras is a free, MIT-licensed CLI that watches your Claude Code and Codex plan usage, forecasts when your 5-hour and weekly limits will run out, and warns, asks first, or pauses the agent at a line you set, with an optional €4.99 macOS menu bar app.

Why it matters

For people on Claude or ChatGPT subscription plans who run coding agents heavily, it prevents one long session from using up the week's allowance before Thursday.

Highlights

• peras status shows 5-hour and 7-day usage, when each resets, and when you'll run out at the current pace.
• At a line you set, it can warn (desktop notification), ask (the next tool call waits for your OK), or pause (tool calls are refused until it lifts or you resume).
• Rules can target pace, a single prompt's cost, overnight hours, or one project folder, and daily or per-project allowances can be budgeted.
• The same hooks work for Codex desktop and CLI, reading usage through Codex's local app-server; the site says Peras reads no login files.
• CLI is local with no dependencies (Node 18+); the native Peras app for macOS costs €4.99 once, or you can build it from source or use a free SwiftBar menu.

Taken from the project's own README, docs or launch page. Claims about speed or accuracy are the maker's unless stated otherwise.

Worth knowing: Peras installs hooks into Claude Code and Codex (peras remove takes them out). The site notes allowance tracking can have gaps and miss usage.

Quick facts

Links

• Official site: https://peras.vertias.eu/
• Repository: https://github.com/Vertias3u/Peras

Related ranking

See how established tools compare in Best AI Coding Tools for Developers. New releases aren't scored until we review them against the rubric.

Checked 2026-10-23 from the tool's own pages. Prices and star counts change, so confirm on the official site. Listing here is not a ranking or an endorsement.