Mixedbread

OpenCode

Use Toast 1 as a primary model or subagent in OpenCode.

Add Toast 1 as a subagent in OpenCode for fast, cheap, and accurate search.

Prerequisites

Configure Mixedbread

Add the Mixedbread provider

Create or update opencode.json in your project root (the directory you open with OpenCode, typically alongside .git, package.json, or pyproject.toml):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "mixedbread": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Mixedbread",
      "options": {
        "baseURL": "https://api.mixedbread.com/v1"
      },
      "models": {
        "toast-1": {
          "name": "Toast 1",
          "limit": {
            "context": 131072,
            "output": 4096
          }
        }
      }
    }
  }
}

The provider ID is mixedbread, and the model ID is toast-1. Together, OpenCode refers to the model as mixedbread/toast-1.

To make Mixedbread available in every project, put the same configuration in ~/.config/opencode/opencode.json instead. A project-level opencode.json overrides the global configuration.

Add your API key

Start OpenCode and enter:

/connect

Select Other, enter mixedbread as the provider ID, then paste your Mixedbread API key. The provider ID must exactly match the key in opencode.json.

Select Toast 1

Enter /models, then select Mixedbread → Toast 1.

To make Toast 1 the default for the project, add the top-level model field to opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "mixedbread/toast-1"
}

Merge this field into the provider configuration from the first step.

Use Toast 1 as a subagent

You can keep another model as your primary OpenCode model and use Toast 1 for focused repository investigations. Merge this agent entry into your existing opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "toast": {
      "description": "Investigates complex repository questions and returns concise, evidence-backed findings",
      "mode": "subagent",
      "model": "mixedbread/toast-1",
      "permission": {
        "edit": "deny",
        "bash": "deny"
      }
    }
  }
}

Invoke the subagent directly with an @ mention:

@toast Trace the authentication flow in this repository and summarize the key files.

OpenCode can also delegate to the subagent when its description matches the task. An explicit @toast mention is the most predictable way to select it.

On this page

PrerequisitesConfigure Mixedbread1Add the Mixedbread provider2Add your API key3Select Toast 1Use Toast 1 as a subagent