How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

pr - Prompt - OpenSmartRoute

Name: pr
Author: draenger

Prompt file imported from draenger/whisperio (.claude/commands/pr.md). Copyright stays with the author.

/pr — whisperio

Pre-flight before pushing. Run from a fresh claude session.

1. Typecheck

npm run typecheck:node
npm run typecheck:web

Both must pass clean. Red on any error.

2. Tests

npm test -- --run

Vitest. Red on any failed test.

3. Lint (if configured)

ls eslint.config.* 2>/dev/null && npx eslint .

Yellow on warnings, red on errors. Skip with note if no eslint config.

4. Build (full electron-vite build)

npm run build

Heavy step (1–3 min). Catches packaging-config errors that typecheck misses.

5. Secret scan

Whisperio is a "bring-your-own-key" app — API keys MUST NOT be in the codebase. Grep diff for:

OpenAI: sk-[a-zA-Z0-9]{20,}, sk-proj-[A-Za-z0-9_-]{20,}
ElevenLabs: xi-[A-Za-z0-9]{32,}
Generic API keys / tokens
.env MUST NOT be in the diff (gitignored, but git add -f .env could leak)

Specifically: ensure no test fixture file contains a real key (use sk-FAKE-… patterns for tests).

6. electron-builder dry-run (when packaging files change)

If git diff --name-only includes electron-builder.yml, package.json (deps / electronBuilder section), or src/main/:

npx electron-builder --dir --publish never

This packages without publishing — surfaces signing / icon / asset / entitlements errors locally before pushing to CI.

7. Code-signing reminder (when macOS code touched)

If git diff includes src/main/ on macOS-specific paths or electron-builder.yml macOS section:

Surface yellow: "macOS builds are currently UNSIGNED. ci is non-blocking on signature check. Either keep unsigned (TestFlight handles signing for the mobile app, desktop ships as 'verify with xattr -cr') or wire up Developer ID."

8. TODO / FIXME audit

git diff --name-only origin/main...HEAD | xargs grep -n -E "TODO|FIXME|XXX" 2>/dev/null

Output

PR pre-flight — whisperio on branch <name>
  ✓ Typecheck (node)     OK
  ✓ Typecheck (web)      OK
  ✓ Tests                32 passed, 0 failed
  ⚠ Lint                 2 warnings (no errors)
  ✓ Build                electron-vite build OK (1m 12s)
  ✓ Secrets              0 hits — keys belong in OS secure store
  ✓ electron-builder     dry-run OK (Windows NSIS target)
  ⚠ TODO                 1 in src/main/hotkey.ts:88

Verdict  PASS-with-notes (2 lint warnings, 1 TODO)

Install pr and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

# /pr — whisperio Pre-flight before pushing. Run from a **fresh** claude session. ## 1. Typecheck ```bash npm run typecheck:node npm run typecheck:web ``` Both must pass clean. Red on any error. ## 2. Tests ```bash npm test -- --run ``` Vitest. Red on any failed test. ## 3. Lint (if configured) ```bash ls eslint.config.* 2>/dev/null && npx eslint . ``` Yellow on warnings, red on errors. Skip with note if no eslint config. ## 4. Build (full electron-vite build) ```bash npm run build ``` Heavy step (1–3 min). Catches packaging-config errors that typecheck misses. ## 5. Secret scan Whisperio is a "bring-your-own-key" app — API keys MUST NOT be in the codebase. Grep diff for: - OpenAI: `sk-[a-zA-Z0-9]{20,}`, `sk-proj-[A-Za-z0-9_-]{20,}` - ElevenLabs: `xi-[A-Za-z0-9]{32,}` - Generic API keys / tokens - `.env` MUST NOT be in the diff (gitignored, but `git add -f .env` could leak) Specifically: ensure no test fixture file contains a real key (use `sk-FAKE-…` patterns for tests). ## 6. electron-builder dry-run (when packaging files change) If `git diff --name-only` includes `electron-builder.yml`, `package.json` (deps / electronBuilder section), or `src/main/`: ```bash npx electron-builder --dir --publish never ``` This packages without publishing — surfaces signing / icon / asset / entitlements errors locally before pushing to CI. ## 7. Code-signing reminder (when macOS code touched) If `git diff` includes `src/main/` on macOS-specific paths or `electron-builder.yml` macOS section: - Surface yellow: "macOS builds are currently UNSIGNED. ci is non-blocking on signature check. Either keep unsigned (TestFlight handles signing for the mobile app, desktop ships as 'verify with xattr -cr') or wire up Developer ID." ## 8. TODO / FIXME audit ```bash git diff --name-only origin/main...HEAD | xargs grep -n -E "TODO|FIXME|XXX" 2>/dev/null ``` ## Output ``` PR pre-flight — whisperio on branch <name> ✓ Typecheck (node) OK ✓ Typecheck (web) OK ✓ Tests 32 passed, 0 failed ⚠ Lint 2 warnings (no errors) ✓ Build electron-vite build OK (1m 12s) ✓ Secrets 0 hits — keys belong in OS secure store ✓ electron-builder dry-run OK (Windows NSIS target) ⚠ TODO 1 in src/main/hotkey.ts:88 Verdict PASS-with-notes (2 lint warnings, 1 TODO) ```

{ "prompt": "# /pr — whisperio\n\nPre-flight before pushing. Run from a **fresh** claude session.\n\n## 1. Typecheck\n\n```bash\nnpm run typecheck:node\nnpm run typecheck:web\n```\n\nBoth must pass clean. Red on any error.\n\n## 2. Tests\n\n```bash\nnpm test -- --run\n```\n\nVitest. Red on any failed test.\n\n## 3. Lint (if configured)\n\n```bash\nls eslint.config.* 2>/dev/null && npx eslint .\n```\n\nYellow on warnings, red on errors. Skip with note if no eslint config.\n\n## 4. Build (full electron-vite build)\n\n```bash\nnpm run build\n```\n\nHeavy step (1–3 min). Catches packaging-config errors that typecheck misses.\n\n## 5. Secret scan\n\nWhisperio is a \"bring-your-own-key\" app — API keys MUST NOT be in the codebase. Grep diff for:\n- OpenAI: `sk-[a-zA-Z0-9]{20,}`, `sk-proj-[A-Za-z0-9_-]{20,}`\n- ElevenLabs: `xi-[A-Za-z0-9]{32,}`\n- Generic API keys / tokens\n- `.env` MUST NOT be in the diff (gitignored, but `git add -f .env` could leak)\n\nSpecifically: ensure no test fixture file contains a real key (use `sk-FAKE-…` patterns for tests).\n\n## 6. electron-builder dry-run (when packaging files change)\n\nIf `git diff --name-only` includes `electron-builder.yml`, `package.json` (deps / electronBuilder section), or `src/main/`:\n\n```bash\nnpx electron-builder --dir --publish never\n```\n\nThis packages without publishing — surfaces signing / icon / asset / entitlements errors locally before pushing to CI.\n\n## 7. Code-signing reminder (when macOS code touched)\n\nIf `git diff` includes `src/main/` on macOS-specific paths or `electron-builder.yml` macOS section:\n- Surface yellow: \"macOS builds are currently UNSIGNED. ci is non-blocking on signature check. Either keep unsigned (TestFlight handles signing for the mobile app, desktop ships as 'verify with xattr -cr') or wire up Developer ID.\"\n\n## 8. TODO / FIXME audit\n\n```bash\ngit diff --name-only origin/main...HEAD | xargs grep -n -E \"TODO|FIXME|XXX\" 2>/dev/null\n```\n\n## Output\n\n```\nPR pre-flight — whisperio on branch <name>\n ✓ Typecheck (node) OK\n ✓ Typecheck (web) OK\n ✓ Tests 32 passed, 0 failed\n ⚠ Lint 2 warnings (no errors)\n ✓ Build electron-vite build OK (1m 12s)\n ✓ Secrets 0 hits — keys belong in OS secure store\n ✓ electron-builder dry-run OK (Windows NSIS target)\n ⚠ TODO 1 in src/main/hotkey.ts:88\n\nVerdict PASS-with-notes (2 lint warnings, 1 TODO)\n```", "variables": [], "notes": "Verify-before-PR for whisperio. Electron desktop (typecheck:node + typecheck:web + tests + electron-vite build), plus secret scan focused on OpenAI/ElevenLabs API keys (which would be a leak — keys live in OS secure store at runtime, never in code), TODO audit, and electron-builder dry-run validation when packaging-relevant files change. Implements the loop-engineer \"don't get the agent self-verify\" rule.", "metadata": { "source": { "provider": "github-claude-commands", "repository": "https://github.com/draenger/whisperio", "path": ".claude/commands/pr.md", "ref": "701b044e2e68ac8d2e2b3a108c12c5bba760082b", "url": "https://github.com/draenger/whisperio/blob/701b044e2e68ac8d2e2b3a108c12c5bba760082b/.claude/commands/pr.md", "key": "draenger/whisperio/.claude/commands/pr.md" } } }

pr

About

/pr — whisperio

1. Typecheck

2. Tests

3. Lint (if configured)

4. Build (full electron-vite build)

5. Secret scan

6. electron-builder dry-run (when packaging files change)

7. Code-signing reminder (when macOS code touched)

8. TODO / FIXME audit

Output

Install pr and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews