Skill

openrouter

Agent-first OpenRouter introspection — terse output for cron and AI agents (--agent and --llm modes), local SQLite...

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use openrouter

Choose if

You're running multi-model LLM workloads through OpenRouter and need agent-native cost attribution (per-caller spend), model shortlisting with accurate pricing pulled from a local 400+ model catalog, provider-degradation detection before dispatch, and weekly-cap monitoring before credit-low alarms fire. Pick this over OpenRouter's web dashboard when the answers need to live inside an agent loop.

Avoid if

You don't have an OpenRouter account / API key (the CLI introspects OpenRouter; it doesn't replace it). Also avoid when you'd prefer the CLI to persist credentials/state automatically — nothing is written to disk by default and per-caller attribution requires an external tool-call logger feeding into a specific directory.

Risk Flags

  • MEDIUM auth Inference operations need OPENROUTER_API_KEY; sub-key management requires a separate OPENROUTER_MANAGEMENT_KEY. Credentials live only in environment variables — nothing persists to disk by default, so restart-safety is the agent's responsibility.
  • MEDIUM rate_limit Upstream OpenRouter rate limits surface as exit code 7. README discloses no concrete thresholds; agents on heavy workloads must monitor the budget command and remaining weekly cap.
  • LOW scope Per-caller cost attribution depends on an external tool-call logger writing to a specific directory. Provider degradation detection needs a historical state file; first runs return empty.
  • LOW runtime Default install needs Node.js (npx) or a pre-built binary. macOS binaries need Gatekeeper quarantine clearance; Unix needs execute permission.

Cost

Type: Free · Free tier: The CLI binary is a free wrapper. All inference spend bills against your OpenRouter account via OPENROUTER_API_KEY; sub-key management requires a separate OPENROUTER_MANAGEMENT_KEY.

Install

Default

npx -y @mvanhorn/printing-press install openrouter

Estimated time to first success: ~5 min

Dependencies

Minimum runtime: Node.js 18+ (or pre-built binary)

Distribution

Repository
https://github.com/mvanhorn/printing-press-library