Set up an AI agent

AI Chat runs an agent CLI that you install and sign in to with your own account. Set up one agent once; then use AI Chat normally inside DBConvert Streams. You do not need to configure MCP separately.

Windows instructions come first because they suit most DBConvert Streams desktop users. For macOS or Linux, use the provider's current installation guide linked below.

Choose an agent

Pick the account and workflow you already use:

If you already use…	Choose
Claude or an Anthropic account	Claude Code
ChatGPT or an OpenAI account	Codex
GitHub Copilot	GitHub Copilot CLI
A local, self-hosted, or another model provider	OpenCode

You can install more than one later and switch providers in AI Chat.

Install on Windows

Open PowerShell from the Start menu. Install one agent, sign in, then fully quit and reopen DBConvert Streams so it can find the new command.

Claude Code

Choose this if you use Claude. DBConvert launches Claude Code through an ACP adapter, so install a current Node.js LTS release first.

irm https://claude.ai/install.ps1 | iex
claude

Follow the browser sign-in flow. Claude Code requires a supported Claude or Anthropic account. For alternatives such as WinGet, see the official Windows guide.

Codex

Choose this if you use ChatGPT or OpenAI. DBConvert launches Codex through an ACP adapter, so install a current Node.js LTS release first. Then follow the current Windows install and sign-in steps in the Codex CLI documentation.

When installation is complete, run:

codex

Choose a sign-in method when prompted, then close Codex.

GitHub Copilot CLI

Choose this if you already have GitHub Copilot.

winget install GitHub.Copilot
copilot

In Copilot, run /login and follow the prompts. See the official installation guide for account and plan requirements.

OpenCode

Choose this for a local, self-hosted, or other model provider. OpenCode recommends WSL for the best Windows experience; its installation choices and authentication methods change more often than the other agents. Follow the OpenCode Windows guide, then run:

opencode auth login

macOS and Linux

Use the provider's current installation guide, then start its command once to sign in:

Claude Code — DBConvert also needs Node.js with npx for the ACP adapter.
Codex — DBConvert also needs Node.js with npx for the ACP adapter.
GitHub Copilot CLI.
OpenCode.

Verify it in DBConvert

Fully quit and reopen DBConvert Streams after installing the agent.
Open AI Chat and click the provider and model chip in the header.
Your agent appears in the Provider list. A provider is unavailable when DBConvert cannot find its required command on your PATH.
Start a session and ask a question about the current context. A real answer confirms that the agent can sign in and reach your workspace.

Choose the provider and model

The header chip (for example, OpenCode · Big Pickle) shows who is answering and opens the settings. Start a session before choosing a model:

Provider (left) — installed agents. Switching providers starts a fresh session with that agent.
Settings (right) — the model and any other options exposed by the selected provider. They vary by provider and may change as its agent evolves.

DBConvert does not add or gate models; the choices depend on your provider account and plan.

Switching provider clears the current chat. A different provider is a different agent process. AI Chat warns when the chat has history; export it (↓ in the header) if you want to keep it.

Using AI Chat — scopes, suggestions, sessions, and the usage badge.
Troubleshooting — agent not appearing, host unavailable, and sign-in issues.