AI NewsDev toolsAnnouncement

Peras pauses coding agents at a weekly usage line, free and MIT

Peras is a free MIT tool. It watches Claude Code and Codex usage. It refuses the next agent tool call once the week hits a line you set.

AI News

Editorial2 min read

LinkedInX
A pixel pear next to the words "Stop Claude Code or Codex before it burns the rest of your limit."

Image: Vertias

Why it mattersA long overnight run can eat the rest of a weekly plan by lunchtime. A hard stop at a chosen line keeps the quota for work the person planned to do.

An overnight agent run can finish the rest of a weekly Claude Code plan before the person wakes up. Peras is a new tool that refuses the next tool call once usage crosses a line the person set. The quota then lasts to the end of the week.

Peras was built by Kristiyan Ivanov at Vertias in Sofia, Bulgaria. Version 0.4 launched on Product Hunt this week. The CLI and the hooks are free and MIT-licensed. A signed macOS app costs €4.99 and runs on macOS 13 or later. The source works on Node 18 and has no other dependencies.

What it does

The tool reads Claude Code's and Codex's own local usage data. Vertias says Peras watches each plan's usage. It tells the person where the week is headed. It can warn, ask, or pause the agent at the line the person set.

Each line can be one of three levels. "Warn" sends a desktop notification and the agent carries on. "Ask" makes the next tool call wait for a one-time approval. "Pause" refuses the next tool call and ends the turn until the window resets or the person runs peras resume.

Lines can be set by weekly share, by the cost of one prompt, by time of day, and by folder. The documentation shows the four shapes in order: peras set weekly pace pause, peras set prompt 3 pause, peras set 01:00-08:00 weekly 50 pause, and peras set --here weekly 60 pause.

How it hooks in

Peras is installed with npx peras-cli setup and adds hooks that Claude Code calls before each tool run. Vertias says the hook "asks Peras: go, ask, or stop." No API keys, no base-URL change, no tokens read.

Codex is set up with a second command, peras codex setup, and keeps its own lines, history and pauses. Codex has no built-in approval prompt, so an "ask" line holds its tools until the person runs peras codex resume.

What it does not stop

Vertias names its own limits. "Stale readings can make a pause late. Requests already in flight and tools outside hook coverage aren't stopped." The folder and per-prompt figures are estimates. The plan's own usage number is account-wide. A client that skips the hooks is not covered. Default check failures may let work proceed, and Vertias says a supported Claude Code version offers an opt-in strict mode.

The site also states, in bold, "Not affiliated with Anthropic or OpenAI."

A monitor shows how much of the week is left on a screen. It cannot stop an agent that is working at 2am while the person is asleep. A hook that refuses the next tool call can. That is the specific gap this tool fills.

Source

Peras by Vertias. GitHub source. Product Hunt listing.

SourceVertias

This item was written by an AI system from the linked source. Reveneau is responsible for what it publishes.

Share
LinkedInX
Start a project