From 3dd46e73dff3ebd5b9b2ae55b9a3e83f34cc456d Mon Sep 17 00:00:00 2001 From: Sebass van Boxel Date: Mon, 15 Jun 2026 20:17:26 +0000 Subject: [PATCH 1/3] docs: add Poolside provider setup instructions Document configuring platform.poolside.ai with OpenCode via its OpenAI-compatible Chat API, including the laguna-m.1 and laguna-xs.2 models. --- packages/web/src/content/docs/providers.mdx | 66 +++++++++++++++++++++ 1 file changed, 66 insertions(+) diff --git a/packages/web/src/content/docs/providers.mdx b/packages/web/src/content/docs/providers.mdx index b31ebb67792c..3bca4b189f35 100644 --- a/packages/web/src/content/docs/providers.mdx +++ b/packages/web/src/content/docs/providers.mdx @@ -1796,6 +1796,72 @@ OpenCode Zen is a list of tested and verified models provided by the OpenCode te --- +### Poolside + +[Poolside](https://platform.poolside.ai) provides an OpenAI-compatible Chat API for its `laguna` family of models. Thinking is enabled by default. + +1. Head over to [platform.poolside.ai](https://platform.poolside.ai), sign in with Google or GitHub, then open the **API Keys** tab and click **New key** to generate an API key. + +2. Run the `/connect` command and scroll down to **Other**. + + ```txt + /connect + ``` + +3. Enter `poolside` as the provider id. + + ```txt + ┌ Enter provider id + │ poolside + └ + ``` + +4. Enter your Poolside API key. + + ```txt + ┌ API key + │ + │ + └ enter + ``` + +5. Add the provider to your `opencode.json` file: + + ```json title="opencode.json" + { + "$schema": "https://opencode.ai/config.json", + "provider": { + "poolside": { + "npm": "@ai-sdk/openai-compatible", + "name": "Poolside", + "options": { + "baseURL": "https://inference.poolside.ai/v1" + }, + "models": { + "poolside/laguna-m.1": { + "name": "Laguna M.1" + }, + "poolside/laguna-xs.2": { + "name": "Laguna XS.2" + } + } + } + } + } + ``` + +6. Run the `/models` command to select a model like _Laguna M.1_. + + ```txt + /models + ``` + +:::tip +You can also install the [`pool` CLI](https://downloads.poolside.ai/pool/install.sh) from the Poolside platform's **Quick Start** tab to use Poolside agents directly from your terminal or editor. +::: + +--- + ### SAP AI Core SAP AI Core provides access to 40+ models from OpenAI, Anthropic, Google, Amazon, Meta, Mistral, and AI21 through a unified platform. From 186adfca8ce86103bf91e5ab912ea4850f43909b Mon Sep 17 00:00:00 2001 From: Sebass van Boxel Date: Mon, 15 Jun 2026 22:44:36 +0200 Subject: [PATCH 2/3] docs: document self-hosted Poolside configuration (#3) * docs: document self-hosted Poolside configuration * Update opencode.json example in providers.mdx Removed model information from opencode.json example. --- packages/web/src/content/docs/providers.mdx | 27 +++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/packages/web/src/content/docs/providers.mdx b/packages/web/src/content/docs/providers.mdx index 3bca4b189f35..e39be5779266 100644 --- a/packages/web/src/content/docs/providers.mdx +++ b/packages/web/src/content/docs/providers.mdx @@ -1856,6 +1856,33 @@ OpenCode Zen is a list of tested and verified models provided by the OpenCode te /models ``` +#### Self-hosted + +If you run Poolside on your own infrastructure, configure it as a custom OpenAI-compatible provider pointed at your deployment's `/openai/v1` endpoint, and provide your API key through the `POOLSIDE_API_KEY` environment variable: + +```bash +export POOLSIDE_API_KEY=your-key-here +``` + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "provider": { + "poolside": { + "npm": "@ai-sdk/openai-compatible", + "name": "Poolside", + "env": ["POOLSIDE_API_KEY"], + "options": { + "baseURL": "https://poolside.example.com/openai/v1" + } + } + } +} +``` + +- **env**: the environment variable(s) opencode reads your API key from. +- **options.baseURL**: your self-hosted endpoint — replace `poolside.example.com` with your deployment's host. The OpenAI-compatible path is `/openai/v1`. + :::tip You can also install the [`pool` CLI](https://downloads.poolside.ai/pool/install.sh) from the Poolside platform's **Quick Start** tab to use Poolside agents directly from your terminal or editor. ::: From b9ea14964e345ae1c79507c4703c43ff59f01973 Mon Sep 17 00:00:00 2001 From: Sebass van Boxel Date: Mon, 15 Jun 2026 22:48:14 +0200 Subject: [PATCH 3/3] Update providers.mdx --- packages/web/src/content/docs/providers.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/web/src/content/docs/providers.mdx b/packages/web/src/content/docs/providers.mdx index e39be5779266..d72ebbaa45d5 100644 --- a/packages/web/src/content/docs/providers.mdx +++ b/packages/web/src/content/docs/providers.mdx @@ -1798,7 +1798,7 @@ OpenCode Zen is a list of tested and verified models provided by the OpenCode te ### Poolside -[Poolside](https://platform.poolside.ai) provides an OpenAI-compatible Chat API for its `laguna` family of models. Thinking is enabled by default. +[Poolside](https://poolside.ai) provides an OpenAI-compatible Chat API for its `Laguna` family of models. Thinking is enabled by default. 1. Head over to [platform.poolside.ai](https://platform.poolside.ai), sign in with Google or GitHub, then open the **API Keys** tab and click **New key** to generate an API key.