Skip to content

apiplan v0.2.0 — every frontier model as a shell command

Choose a tag to compare

@fire17 fire17 released this 28 Jul 14:56
· 150 commits to main since this release

Call frontier models from your shell using the Claude Code and Codex subscriptions you already have — no API key, no per-token bill.

opus explain monads in one sentence
cat server.log | sonnet find the root cause | pbcopy
sol -i screenshot.png what is wrong with this layout

Highlights

  • One command per model — opus sonnet fable haiku sol luna terra, plus *-fast twins. No quotes needed around your question.
  • Family names age well. opus means the newest Opus (today claude-opus-5); explicit versions stay reachable (opus48, sonnet46, gpt55, and opus4.8/Opus-4-8 all resolve). Model lists come from each provider's own endpoint, so a new release needs no code change.
  • Two providers, one engine. Anthropic /v1/messages and OpenAI's Codex Responses endpoint behind a single adapter interface. Every alias is verified against the API's own served-model field.
  • Multimodal + pipes. -i accepts a file, URL, data: URI, stdin, or your clipboard; stdin appends to the prompt; output pipes onward.
  • Warm daemon. Caches the credential and holds the provider connection open. Our own overhead on a warm call is 4 ms, measured inside the client — and a cold call never waits for the daemon.
  • apiplan control CLI + TUI. See which providers you're connected to, which models exist and what reaches them, and every command on your PATH — then rename any of them or invent new ones with baked-in flags. Commands are plain JSON, not code.
  • Cross-platform by construction. One file owns every macOS/Linux/WSL/Windows difference: credential location, sh vs .cmd+.ps1 shims, unix socket vs token-protected loopback TCP, clipboard mechanism.

Verified

80 tests · 7 of 7 performance budgets · apiplan doctor all clear · 25 parallel calls 25/25 (p50 1.06 s) · tests pass from a fresh clone of this tag.

Live-verified on macOS. Linux, WSL and Windows are unit-tested (including the Windows transport forced on macOS) but have not yet been run on those systems — see the README's cross-platform section.

Reading

DARWIN.md logs five measure-fix-verify rounds, including the round where the "warm" daemon turned out to be making every call 1.6 s slower, an optimisation that was measured and rejected, and the perf budget that was found to be measuring network weather instead of code.

MIT.