Granular Granular

Connect OpenCode

In short

Use your own OpenCode agent as a Granular chat engine. Install it in one click, connect a provider such as OpenRouter or Anthropic (or reuse one you added in Granular), then pick its models.

Updated 2026-10-20

OpenCode is a free, open-source AI coding agent. Granular can use it as the engine behind a chat, with any AI provider OpenCode supports, such as OpenRouter, Anthropic or OpenAI. If you've already signed in to OpenRouter or added a provider key in Granular, OpenCode can use that straight away.

Before you start

  • One of these:
  • OpenCode's own free models don't work inside Granular (see Limits).
  • On Windows, the one-click install needs Node.js. If it's missing, Granular says so and links to it.

Set it up

  1. In the row of controls under the message box, click the button that shows your current connection's name.
  2. Click Add your AI agent.
  3. Under Coding agents, click OpenCode. Its tag says Install, Sign in or Ready, and its price tag says Free + model (OpenCode is free; you pay for the AI model you connect to it).
  4. If OpenCode isn't installed yet, a panel says "OpenCode needs a one-time install". Click Install for me. Granular types the official install command into the chat's Terminal tool so you can watch it run, then carries on by itself once OpenCode is found.
  5. If OpenCode still needs a provider, it opens in the Terminal tool with the panel Connect a provider to OpenCode. Pick a provider there, then paste its API key or sign in.
  6. An OpenCode row appears in your Accounts list and the chat switches to it.

If the tag already says Ready, OpenCode is using an account you added in Granular. Point at the row to see which one, for example "Uses your OpenRouter account".

What you'll see

  • The OpenCode row in Accounts names the providers OpenCode can use.
  • The model button under the message box lists the models OpenCode can reach through those providers. You can search the list and pin favourites. See Pick and pin models.
  • OpenCode's own free models appear greyed out, with the reason when you point at them.
  • When the agent runs a command, it runs in the chat's Terminal tool where you can see it. File changes go through Granular too, so they show in the chat.

Change or undo it

  • Connect another provider: run opencode auth login in the chat's Terminal tool and follow OpenCode's steps.
  • Stop using it in a chat: pick another account from the connection button.
  • Hide it: open Settings → AI accounts and click Hide from picker on OpenCode's card. OpenCode stays set up; Granular just stops showing and using it. See Manage your AI accounts.
  • Sign out of a provider inside OpenCode: run opencode auth logout in a terminal.

Limits

  • OpenCode's free models don't work in Granular. OpenCode only lets its free models run when its own command tool is switched on. Granular switches it off so that every command runs in your visible terminal, so those models are shown greyed out. Use a provider of your own instead.
  • OpenCode's own command and edit tools are off. The agent uses Granular's terminal and file tools instead, so you can see every command and change.
  • Costs depend on the provider OpenCode uses. Granular doesn't charge for OpenCode chats.
  • Your OpenCode settings aren't changed. Granular passes its settings, and any key it lends OpenCode, for each reply only. If you've also signed in inside OpenCode, OpenCode's own sign-in is used first.

Troubleshooting

If you see "OpenCode's free models only work inside OpenCode's own app, so Granular can't use them"
Pick a model from a provider you've connected, or connect one by running opencode auth login in the terminal.

If the install finished but Granular can't see OpenCode
Click I've installed it - check again in the install panel. If that doesn't find it, quit Granular completely and open it again.

If the Windows install says it needs Node.js
Install Node.js from the link in the panel, or install OpenCode with Scoop (scoop install opencode) or Chocolatey (choco install opencode), then click I've installed it - check again.

Questions

Can I use OpenCode inside Granular?
Yes. Open Add your AI agent, click OpenCode under Coding agents, install it if needed, and connect a provider.
Do I have to set up a provider inside OpenCode?
Not if you've already signed in to OpenRouter or added a provider key in Granular. OpenCode uses that automatically.
Why are OpenCode's free models greyed out?
They only run inside OpenCode's own app with its command tool on. Granular keeps that tool off so commands run where you can see them.
Does Granular change my OpenCode settings?
No. Its settings are passed for each reply only.
Does it work on Windows?
Yes. The one-click install uses npm, so it needs Node.js, or you can use Scoop or Chocolatey.

Related

Guides
Pick and pin models
Choose the AI model for a chat from the model button under the message box. Search every account, read the badges, and pin favourites with Cmd+D or Ctrl+D.
Guides
Connect Pi
Use the Pi coding agent as a Granular chat engine. Install it in one click, then reuse a provider you added in Granular or connect OpenRouter, Anthropic, OpenAI or xAI with /login.
Guides
Manage your AI accounts
Settings → AI accounts shows every AI account Granular can use, how each connects, what it costs and whether it works. Check it, sign in again, set a project default, hide or remove it.
Guides
Connect an AI model
All the ways to connect an AI model to Granular: sign in with Claude or Codex, plug in a coding agent like Cursor or GitHub Copilot, add a key, sign in to OpenRouter, run local models, or use the AI Add-on.