How to install
From a terminal, run npx pennyrouter install. It needs Node.js, which includes npx; if you don’t have it, get it from nodejs.org.
How to use
From a terminal
penny claude
Launch Claude Code with PennyRouter optimizations.
penny codex
Launch Codex with PennyRouter optimizations.
From the Mac app
Click to launch terminal or desktop app.
Exploring costs
penny claude --stats
Opens a session with real-time usage and cost, priced at API rates. Works with penny codex --stats too.
penny compare
Runs both a native session and a PennyRouter session side by side, enabling direct cost comparison. Optionally, you can share your comparison results in the PennyRouter gallery.
@penny savings
Send as a prompt in any session for an estimated native versus PennyRouter cost. The native metrics are calculated counterfactuals, not measured charges. See methods for additional details. For precise measurements, use penny compare.
WebsiteSee the cost overview and the detailed savings pages.
Extra Penny features
During any session, send a prompt with the following to access PennyRouter extra features.
@penny consult [model] [question]
Get input from a higher-tier model, such as Opus or Sol, while you work on a lower-tier one.
@penny import session <link>
Bring in a shared conversation from ChatGPT, Claude, Gemini, or Perplexity.
@penny transfer to <claude | codex>
Move a session from one harness to the other.
@penny mode
Change session parameters to cost-optimize for quick, light sessions or for deeper, more complex work.
@penny complain
Send feedback to the developers about any issue.