Description
Peras is a tool designed to help users manage their usage of Claude Pro/Max or ChatGPT plans by monitoring and providing insights on weekly trends. It allows users to set limits and automatically pauses the agents when these limits are reached. The tool is free, MIT-licensed, and operates locally, ensuring privacy and security. Users can choose to build the app themselves or purchase a ready-made macOS app for a one-time fee of €4.99, which includes updates.
Read More
The tool features a user-friendly interface where a pear icon sits next to the clock, displaying each agent's 5-hour usage. Users can click on it to view weekly usage bars, reset windows, and pause buttons for Claude Code and Codex separately. The tool offers flexibility with notifications and allows users to decide which alerts they receive.
Peras provides a comprehensive view of usage, including daily tracking and weekly charts that show observed usage, remaining allowance, and any recording gaps. It supports both desktop and CLI usage, with commands available for managing Codex as well. The tool ensures that all data stays on the user's machine, with no product telemetry or account requirements.
The optional macOS app supports macOS 13 or later and requires Node 18+. It is compatible with both Apple silicon and Intel architectures, although testing has primarily been conducted on Apple silicon. Users can install the CLI globally or use npx for command execution. The tool maintains separate usage limits for Claude Code and Codex, ensuring that each agent's usage is tracked independently.
- CategoryProductivity
- Pricing ModelFreemium
- DeploymentLocal
- PlatformsmacOS
Peras's Core Features
Monitors Claude Pro/Max and ChatGPT usage
Pauses agents at user-defined limits
Free and MIT-licensed
Optional macOS app available
Local operation with no telemetry
Separate tracking for Claude Code and Codex
User-friendly interface with notifications
CLI and desktop support
How to use Peras?
Configure: Set your usage limits and preferences
Monitor: Check usage through the pear icon
Pause: Use the pause button when limits are reached
Resume: Restart sessions with the resume command
Peras's Use Cases
- Usage Monitoring
- Agent Pausing
- Local Privacy
- Separate Tracking
- Custom Notifications






