Pi

Pi is a minimal terminal coding harness that defines model providers in ~/.pi/agent/models.json. Add Routeplane as an OpenAI-compatible provider and Pi routes across the whole registry.

Prerequisites

• Routeplane running — local proxy at http://127.0.0.1:4356. Routeplane Cloud is on the Phase D roadmap and not yet shipping; for now, self-host with your own provider keys.

• Pi installed:

  npm install -g --ignore-scripts @earendil-works/pi-coding-agent

Point Pi at Routeplane

Add a provider to ~/.pi/agent/models.json. Use api: "openai-completions" and point baseUrl at the /v1 root.

{
  "providers": {
    "routeplane": {
      "baseUrl": "http://127.0.0.1:4356/v1",
      "api": "openai-completions",
      "apiKey": "local-placeholder",
      "models": [
        { "id": "openai/gpt-4o", "name": "GPT-4o via Routeplane" },
        { "id": "anthropic/claude-sonnet-4-6", "name": "Claude Sonnet 4.6 via Routeplane" }
      ]
    }
  }
}

Then pick the model with /model in the TUI.

**No key for the local proxy** — `apiKey` can be any placeholder. Routeplane Cloud is on the Phase D roadmap; the cloud endpoint is not yet shipping.

Pick a model

Each models[].id is a registry id in provider/model form, optionally with a :cost / :latency variant. See Models.

Learn more

• Pi — custom providers
• Model fallback