Is there official documentation or a guide for setting up OpenCode Free?

[saifkamaal]

I'm trying to configure OmniRoute with the OpenCode Free provider, but I can't get it to work with my coding tool. My dashboard shows that the accounts are successfully connected and the proxy status is active, but requests aren't going through.
Is there a central documentation page, a step-by-step guide, or a GitHub README section that covers how to set this up correctly from scratch?

v3.8.51

[diegosouzapw]

Hi @saifkamaal. There's no single setup page, because OpenCode Free doesn't behave like a normal keyed provider. Its upstream only accepts requests that look like the OpenCode client, and which tool names it accepts has changed from day to day. So "connected and active" in the dashboard doesn't mean requests will pass.

What I know works, from the discussion in #14139 (and confirmed there by a user on the current image):

• A request from a real client that sends its tools (OpenCode, Claude Code, an agent) is fine, because OmniRoute learns the accepted tool names from those requests and reuses them.
• A dashboard Test button, or a script that sends no tools, gets refused with a 403 on a fresh container.
• If you need tool-less requests to work from a cold start, set OPENCODE_FREE_TIER_PLACEHOLDER_TOOLS (documented in .env.example).

I can't say what's failing for you without details. Please tell me: the exact error text, the client you use, the model id (for example oc/...-free), and whether your API key has a connection allowlist (a key restricted to other connections gets a 403 that says so; see #15540).

[diegosouzapw]

@saifkamaal -- still happening on the latest version (3.8.52)? Otherwise I'll close this in 7 days for inactivity.