@juanbenjumea/pi-multi-opencode-go

Multi-account failover for Pi’s opencode-go provider. Rotates API keys using live usage from the official OpenCode Go usage API (rolling / weekly / monthly), overrides Authorization per request, and persists cooldowns when limits hit.

Inspired by pi-multicodex and pi-multi-account, but built for OpenCode Go.

Usage fetching lives in @juanbenjumea/pi-provider-usage-fetcher (shared with @juanbenjumea/pi-dynamic-footer). Since v0.2.0 it uses the official API (GET https://opencode.ai/zen/go/v1/usage, same key as chat completions) — no workspace cookies or dashboard HTML scraping.

Install

pi install npm:@juanbenjumea/pi-multi-opencode-go
/reload

From this monorepo (before publishing):

# settings.json packages entry (relative to pi/agent/settings.json):
# "../packages/pi-multi-opencode-go"
pi -e /path/to/dotfiles/pi/packages/pi-multi-opencode-go

Requirements

• Node 20+
• @earendil-works/pi-coding-agent ≥ 0.80
• A primary opencode-go API key in auth.json (or env) so Pi passes its auth check; this extension overrides the header on each request.

Recommended in settings.json:

{
  "retry": {
    "provider": { "maxRetries": 0 }
  }
}

Configure accounts

Environment (up to 8 slots):

export OPENCODE_API_KEY_1="oc_..."
export OPENCODE_GO_LABEL_1="sub-1"

(OPENCODE_GO_WORKSPACE_ID_1 / OPENCODE_GO_AUTH_COOKIE_1 are optional legacy fields, ignored now.)

~/.pi/agent/auth.json:

{
  "opencode-go-failover": {
    "accounts": [
      {
        "label": "sub-1",
        "key": "$OPENCODE_API_KEY_1"
      }
    ]
  }
}

Only key is required — the usage API authenticates with the same key as chat completions. Legacy workspaceId / authCookie fields are accepted but unused.

Env and auth.json are merged (both load). When an env key collides with an auth.json key, the auth.json entry wins so its label/workspace metadata is kept — e.g. auth.json referencing "key": "$OPENCODE_API_KEY_2" while OPENCODE_API_KEY_2 is also exported must not shadow it with an anonymous account-2.

Values support $ENV, $$literal, and !command (shell — use only if you trust your config).

Commands

Companion extensions

Sets globals for footers and slot ladders:

• __opencode_go_active_label — active account label
• __opencode_go_has_fallback — another non-cooled account exists
• __opencode_go_all_exhausted — every account on cooldown

State: ~/.pi/agent/opencode-go-failover-state.json (mode 0600).
Debug log: ~/.pi/agent/opencode-go-failover.log (labels only, no secrets).

Security

This extension reads API keys from your agent directory. Review the source before installing. Do not commit auth.json or state files.

Publish

cd pi/packages/pi-multi-opencode-go
npm publish --access public

Then switch settings.json to npm:@juanbenjumea/pi-multi-opencode-go@0.1.0.

License

MIT