pennyrouter
v0.1.6
Published
Install and manage PennyRouter local coding-agent integrations.
Readme
PennyRouter CLI
Official local installer for PennyRouter coding-agent integrations.
PennyRouter is a model gateway for coding tools. This CLI handles the local setup work that agents should not do by hand: browser authorization, API-key handoff, config edits, backups, status checks, and uninstall metadata.
Usage
npx pennyrouter install
npx pennyrouter install --existing-account
npx pennyrouter install --harness claude-code,cline,opencode,codex,windsurf,zed,codegpt,aider
npx pennyrouter disable
npx pennyrouter enable
npx pennyrouter uninstall
npx pennyrouter statusWith no --harness flag, the interactive installer shows a checkbox list. Tools with
detected configs start checked; press Enter to accept or type tool IDs to toggle them.
Supported Tools
- Claude Code
- Cline (manual setup instructions; no VS Code settings mutation)
- Codex
- opencode
- Windsurf
- Zed
- JetBrains CodeGPT (manual setup instructions; no XML mutation)
- Aider
Penny Models
Tools that expose a model picker get four curated choices:
- Penny Core:
pennyrouter/penny-core:premium - Penny Speed:
pennyrouter/penny-speed:standard - Penny Power:
pennyrouter/penny-power:premium - Penny Custom:
pennyrouter/auto, using the bundle/profile saved in the user's PennyRouter account
Agent Flow
Users can ask a coding agent to follow:
https://pennyrouter.com/installThat machine-readable page tells the agent to invoke this CLI instead of editing config files directly.
What It Changes
The CLI writes only selected local tool configuration files, saves backups under the local PennyRouter state directory, and records an uninstall manifest.
disable temporarily removes PennyRouter from selected tools while retaining a local
PennyRouter-managed snapshot for enable.
It does not delete PennyRouter accounts, credits, or remote API keys.
License
MIT
