Ecosystem

The OpenCode ecosystem comprises providers, plugins, skills, agents, MCP servers, and community contributions. Together they create a flexible platform for AI-assisted software engineering.

Providers

Providers connect OpenCode to LLM backends. The ecosystem includes:

• Cloud providers: Anthropic, OpenAI, Google, AWS Bedrock, Azure, Groq, Together AI, Fireworks, Mistral, Cohere
• Local providers: Ollama, LM Studio, llama.cpp, vLLM, text-generation-webui
• Custom providers: Any OpenAI-compatible API via @ai-sdk/openai-compatible

Discover and configure providers through the Models.dev directory.

Plugins

Community and official plugins extend OpenCode with new capabilities:

Plugin	Description
opencode-helicone-session	Observability and analytics via Helicone
@my-org/gitlab-tools	GitLab MR, issue, and pipeline management
opencode-jira	Jira ticket lookup and creation
opencode-slack	Slack message search and send
opencode-docker	Docker container and image management

See the Plugins guide for authoring and installing plugins.

Skills

Skills package repeatable workflows into reusable modules. They are ideal for:

• Code review workflows
• Database migration generation
• API client scaffolding
• Documentation generation
• Refactoring patterns

Skills are stored in .opencode/skills/ or ~/.config/opencode/skills/ and are loaded automatically. Each skill is a directory with a SKILL.md file and optional resource files.

# Create a skill
mkdir -p .opencode/skills/security-review

# .opencode/skills/security-review/SKILL.md

Review code for common security vulnerabilities including:
- SQL injection
- XSS
- CSRF
- Insecure deserialization
- Hardcoded secrets

## Usage

Run this skill when asked to perform a security audit.

Agents

Agents are specialized assistants configured for specific modes and domains. The ecosystem includes pre-built agent definitions:

• Build agent: Default coding assistant with full tool access
• Plan agent: Architecture and design focused, uses plan mode
• Custom agents: Define your own in opencode.json

{
  "agent": {
    "security-expert": {
      "mode": "plan",
      "model": "anthropic/claude-sonnet-4",
      "system": "You are a security engineering expert. Analyze code for vulnerabilities.",
      "temperature": 0.1,
      "permission": {
        "read_file": "allow",
        "run_command": "deny"
      }
    }
  }
}

MCP Servers

The Model Context Protocol (MCP) servers connect OpenCode to external tools and data sources:

• Filesystem: Access local files with restricted paths
• GitHub: Repository management, PRs, issues
• PostgreSQL: Database schema inspection and querying
• Puppeteer: Browser automation and web scraping
• Sentry: Error tracking and performance monitoring

Configure MCP servers in opencode.json:

{
  "mcp": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
    },
    "github": {
      "type": "url",
      "url": "https://mcp.github.com/sse",
      "enabled": true
    }
  }
}

Community

• GitHub: github.com/anomalyco/opencode — source code, issues, discussions
• Discord: opencode.ai/discord — community chat, support, announcements
• Models.dev: models.dev — provider and model discovery directory

Contribution Opportunities

There are many ways to contribute to the OpenCode ecosystem:

Publish a Plugin

Package your custom tools and hooks as an npm package. Plugins are the primary way to share integrations with the community. Follow the SDK guide for plugin development.

Add a Provider

If you use a model provider that isn't supported, create a custom provider configuration and share it. Submit a pull request to add it to the built-in provider list.

Create a Skill

Share repeatable workflows as skills. Skills are plain markdown files with structured instructions — easy to create and distribute.

Improve Documentation

Documentation contributions are always welcome. Submit PRs against the docs repository to fix errors, add examples, or write new guides.

Report Issues

Found a bug or missing feature? Open an issue on GitHub with a clear description and reproduction steps.

Join the Community

Participate in Discord discussions, answer questions, and help other users. The community grows stronger with every contribution.

Architecture Overview

                    +-----------------+
                    |   OpenCode CLI  |
                    +--------+--------+
                             |
            +----------------+----------------+
            |                |                |
     +------v------+  +-----v-----+  +------v------+
     |   TUI App   |  |  Server   |  |  Run (CLI)  |
     +------+------+  +-----+-----+  +------+------+
            |                |                |
            +--------+------+----------------+
                     |
            +--------v--------+
            |   Agent Engine   |
            +--------+--------+
                     |
        +------------+------------+
        |            |            |
   +----v----+  +---v----+  +---v----+
   | Models  |  | Tools  |  |  MCP   |
   +----+----+  +---+----+  +---+----+
        |           |           |
   +----v----+     |      +----v----+
   |Providers|     |      |External |
   +---------+     |      |Services |
                   |      +---------+
            +------v------+
            |   Plugins   |
            +-------------+