From aa6516e862af383f5a0a0cc29685c447b3e81a2a Mon Sep 17 00:00:00 2001 From: Rafael Macalaba Date: Sun, 9 Aug 2026 20:40:50 -0400 Subject: [PATCH] docs: add OpenRouter discounted models and provider ordering guide --- README.md | 12 ++++++++++++ docs/auth-and-cost.md | 22 ++++++++++++++++++++++ 2 files changed, 34 insertions(+) diff --git a/README.md b/README.md index cabf354..949f477 100644 --- a/README.md +++ b/README.md @@ -99,6 +99,18 @@ npx @rafamacalaba/armada@latest new my-app Requires Node.js 22+ and an authenticated [opencode](https://opencode.ai) install. Run `armada doctor` to confirm your environment is ready. +### OpenRouter Provider Discounts + +Save up to 20x on OpenRouter models by routing to discounted providers (Novita, StreamLake, Xiaomi): + +```bash +# Check live OpenRouter provider prices and savings multipliers +armada models --discounts + +# Init repo with a preferred discounted provider +armada init --openrouter-provider Novita +``` + After `armada init`, open the repo in opencode. The fleet is loaded. Describe your goal in plain language — a wish, a ticket, a PRD — and the **Commodore** (orchestrator) interviews you for the missing details. Together you produce the contract (`armada/REQUIREMENTS.md`) with phases, dependencies, and measurable success criteria. Once you approve, the fleet runs the loop autonomously until a PR opens. ## The fleet diff --git a/docs/auth-and-cost.md b/docs/auth-and-cost.md index dd7b5d5..495ec24 100644 --- a/docs/auth-and-cost.md +++ b/docs/auth-and-cost.md @@ -54,6 +54,28 @@ Source: `src/model-catalog.js:34-100`. `armada models [budget]` prints the curre manifest at `armada/armada.yaml:44`), then re-scaffold with `armada init --from-armada armada/armada.yaml`. +### Discounted OpenRouter Models & Provider Ordering + +OpenRouter offers third-party provider backends (e.g. Novita, StreamLake, Xiaomi, GMICloud, DeepInfra) that frequently offer **4x to 20x price discounts** over standard endpoints. + +- **Inspect Live Discounts:** Run `armada models --discounts` to query OpenRouter's live API endpoints, calculate per-1M-token prompt/completion pricing, and display provider savings multipliers. +- **Set Provider Ordering via CLI:** + ```bash + armada init --openrouter-provider Novita + # or multiple preferred providers in priority order: + armada init --openrouter-provider "Novita, StreamLake" + ``` +- **Set Provider Ordering via Manifest (`armada.yaml`):** + ```yaml + project: + name: my-project + budget: balanced + openrouter_providers: + - Novita + - StreamLake + ``` +When configured, Armada automatically injects `"order": ["Novita", "StreamLake"]` into `options.provider` for all OpenRouter model definitions in `opencode.json`, ensuring OpenRouter prioritizes the cheapest provider first. + ## Cost expectations Costs are provider-billed (opencode providers and OpenRouter bill the account that owns the