All tools
Setup guide

Use onomeo in OpenCode

OpenCode is a coding agent that runs in the terminal. Add onomeo as a custom provider in its configuration file, connect your key, and choose a model.

A coding agent for the terminal.

The three values it asks for

OpenAI-compatible

Use these details in any OpenAI-compatible tool.

Base URL
/v1
API key
Model

No key yet? Create one on the dashboard, then come back — the fields below fill in by themselves. Go to the dashboard

Step by step

  1. Create opencode.json in your project folder, or open it if it exists, and add the provider below with a model name from the models page.
  2. Start OpenCode and run /connect. Scroll to Other, enter onomeo as the provider ID, and paste your key.
  3. Run /models and choose the onomeo model you added.
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "onomeo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "onomeo",
      "options": {
        "baseURL": "https://onomeo.com/v1"
      },
      "models": {
        "MODEL_NAME": {
          "name": "MODEL_NAME"
        }
      }
    }
  }
}

If it will not connect

  • The provider ID entered after /connect must match the name under "provider": onomeo in both places.
  • Every model you want to use has to be listed under "models". Add one entry per model.
  • To keep the key in an environment variable instead, add "apiKey": "{env:ONOMEO_API_KEY}" under "options".
OpenCode's own documentation