OpenCode

OpenCode is an open source AI coding agent that supports multiple AI providers including OpenAI, Anthropic, and Google.

The Vicoa integration with OpenCode is open source and available at github.com/vicoa-ai/opencode-vicoa.

Installation

Via Vicoa CLI (Recommended)

The easiest way to get started is through the Vicoa CLI, which automatically installs and configures the OpenCode plugin:

# Install Vicoa CLI, if you haven't done so
pip install vicoa 

# Launch OpenCode with Vicoa integration
vicoa opencode

After authentication via the web portal, you're ready to use OpenCode from anywhere.

Manual Installation

If you prefer manual setup, add the plugin to your OpenCode config (~/.config/opencode/config.json):

{
  "$schema": "https://opencode.ai/config.json",
  "plugins": ["opencode-vicoa"]
}

Then authenticate with Vicoa CLI or set your API key manually:

export VICOA_API_KEY="your-vicoa-api-key"

Usage

Starting a Session

Once installed, you can launch OpenCode in two ways:

Option 1: Direct OpenCode command

opencode

OpenCode will automatically sync with Vicoa when the plugin is installed.

Option 2: Via Vicoa CLI

vicoa opencode

This additionally prepares project files for fuzzy search on Vicoa mobile and web apps.

Using OpenCode for a Single Session

If you want to use OpenCode temporarily without changing your default agent:

vicoa --agent opencode

This keeps your default agent unchanged for future sessions.

Making OpenCode Your Default Agent

To make vicoa always launch OpenCode by default:

vicoa --set-default opencode

After running this command, vicoa will automatically launch OpenCode. You can override for a single session with vicoa --agent claude or vicoa --agent codex.

Upgrading the Plugin

Keep the OpenCode plugin up to date with:

vicoa opencode --upgrade

This clears the cached plugin so OpenCode fetches the latest version on the next run.

On this page