OpenCode Support - Everything Claude Code

Everything Claude Code provides full OpenCode support including plugins, hooks, and native custom tools. OpenCode’s plugin system is more sophisticated than Claude Code with 20+ event types.

Overview

OpenCode is a next-generation AI coding assistant with a powerful plugin system. ECC leverages OpenCode’s advanced capabilities to provide richer automation than Claude Code.

Feature Parity Table

Feature	Claude Code	OpenCode	Status
Agents	✅ 13 agents	✅ 12 agents	Claude Code leads
Commands	✅ 33 commands	✅ 24 commands	Claude Code leads
Skills	✅ 50+ skills	✅ 37 skills	Claude Code leads
Hooks	✅ 8 event types	✅ 11 events	OpenCode has more! 🚀
Rules	✅ 29 rules	✅ 13 instructions	Claude Code leads
MCP Servers	✅ 14 servers	✅ Full	Full parity
Custom Tools	✅ Via hooks	✅ 6 native tools	OpenCode is better 🚀

OpenCode Advantages: More hook events (20+ vs 8), native custom tools, richer plugin API

Installation

Option 1: Use Directly

cd everything-claude-code
opencode

OpenCode automatically detects .opencode/opencode.json configuration.

Option 2: Install as npm Package

npm install ecc-universal

Then add to your opencode.json:

{
  "plugin": ["ecc-universal"]
}

Prerequisites

# Install OpenCode
npm install -g opencode

# Verify installation
opencode --version

Hook Support via Plugins

OpenCode’s plugin system is MORE sophisticated than Claude Code with 20+ event types.

Event Mapping

Claude Code Hook	OpenCode Plugin Event
PreToolUse	`tool.execute.before`
PostToolUse	`tool.execute.after`
Stop	`session.idle`
SessionStart	`session.created`
SessionEnd	`session.deleted`

Additional OpenCode Events

OpenCode provides exclusive events not available in Claude Code:

File Events (5)

file.created — When a new file is created
file.edited — After file modifications (like Cursor’s afterFileEdit)
file.deleted — When a file is deleted
file.watcher.created — File system watcher detects new file
file.watcher.updated — File system watcher detects changes

Session Events (4)

session.created — Session starts
session.deleted — Session ends
session.idle — User inactive
session.restored — Session restored from save

Message Events (2)

message.created — New message sent
message.updated — Message edited

LSP Events (2)

lsp.client.diagnostics — Language server diagnostics (errors, warnings)
lsp.client.connected — Language server connection established

UI Events (2)

tui.toast.show — Show toast notification
tui.modal.open — Open modal dialog

Tool Events (2)

tool.execute.before — Before tool execution
tool.execute.after — After tool execution

MCP Events (2)

mcp.tool.before — Before MCP tool call
mcp.tool.after — After MCP tool call

Hook Examples

// Auto-format on file edit (like Cursor's afterFileEdit)
plugin.on('file.edited', async ({ path }) => {
  if (path.endsWith('.ts') || path.endsWith('.tsx')) {
    await exec(`npx prettier --write ${path}`);
    await exec(`npx tsc --noEmit`);
  }
});

6 Native Custom Tools

OpenCode provides native custom tools that Claude Code only achieves via hooks:

run-tests

Execute test suite with coverage reporting

/run-tests --coverage --watch

check-coverage

Verify code coverage meets threshold (80%+)

/check-coverage --threshold 80

security-audit

Run security audits (AgentShield, npm audit, etc.)

/security-audit --fix

format-code

Format code with Prettier/ESLint/etc.

/format-code --check

build-check

Run TypeScript/build checks without emitting

/build-check --strict

dependency-check

Check for outdated or vulnerable dependencies

/dependency-check --update

Tool Configuration

.opencode/opencode.json:

{
  "tools": [
    {
      "name": "run-tests",
      "command": "npm test",
      "args": ["--coverage"],
      "description": "Run test suite with coverage"
    },
    {
      "name": "security-audit",
      "command": "npx",
      "args": ["ecc-agentshield", "scan"],
      "description": "Run AgentShield security audit"
    }
  ]
}

24 Available Commands

OpenCode supports a curated subset of ECC commands:

Core Workflow (8)
Testing & Quality (4)
Continuous Learning (7)
Language-Specific (3)
Utilities (2)

/plan — Create implementation plan
/tdd — Enforce TDD workflow
/code-review — Review code changes
/build-fix — Fix build errors
/e2e — Generate E2E tests
/refactor-clean — Remove dead code
/orchestrate — Multi-agent workflow
/verify — Run verification loop

/test-coverage — Analyze coverage
/checkpoint — Save verification state
/eval — Evaluate against criteria
/update-docs — Update documentation

/learn — Extract patterns from session
/learn-eval — Extract and evaluate patterns
/instinct-status — View learned instincts
/instinct-import — Import instincts
/instinct-export — Export instincts
/evolve — Cluster instincts into skills
/promote — Promote project instincts to global scope

/go-review — Go code review
/go-test — Go TDD workflow
/python-review — Python code review (PEP 8, type hints, security)

/setup-pm — Configure package manager
/sessions — Manage session history

Configuration

opencode.json Structure

{
  "plugin": ["ecc-universal"],
  "model": "claude-sonnet-4.6",
  "temperature": 0.7,
  "maxTokens": 10000
}

Usage Examples

Starting a Feature

opencode

> "Plan authentication with OAuth"
# → Uses planner agent via plugin

> "Implement with TDD"
# → Uses tdd-workflow skill

> "Run tests and check coverage"
# → Uses run-tests custom tool
> /check-coverage --threshold 80

Auto-Formatting Workflow

.opencode/hooks/file-edited.js

// Automatically triggered on file save
module.exports = async ({ path }) => {
  if (path.match(/\.(ts|tsx|js|jsx)$/)) {
    // Auto-format
    await exec(`npx prettier --write ${path}`);
    
    // Type check
    await exec(`npx tsc --noEmit`);
    
    // Lint
    await exec(`npx eslint ${path} --fix`);
  }
};

Security Audit on Commit

.opencode/hooks/session-end.js

// Run security audit before session ends
module.exports = async () => {
  console.log('Running security audit...');
  
  const result = await exec('npx ecc-agentshield scan --json');
  const audit = JSON.parse(result);
  
  if (audit.criticalIssues > 0) {
    throw new Error(`Security audit failed: ${audit.criticalIssues} critical issues`);
  }
};

Documentation

ECC provides comprehensive OpenCode documentation:

Migration Guide

.opencode/MIGRATION.md — Migrate from Claude Code

Plugin README

.opencode/README.md — OpenCode plugin details

Consolidated Rules

.opencode/instructions/INSTRUCTIONS.md — All rules in one file

LLM Documentation

llms.txt — Complete OpenCode docs for LLMs

Best Practices

Leverage Events

Use OpenCode’s 20+ events for richer automation

Custom Tools

Define project-specific tools in opencode.json

Hook Chaining

Chain multiple hooks for complex workflows

LSP Integration

Use lsp.client.diagnostics for real-time feedback

Feature Comparison

OpenCode Exclusive Features

File Watcher Events

OpenCode detects file changes via OS-level watchers, not just AI edits:

plugin.on('file.watcher.updated', ({ path }) => {
  console.log(`External change detected: ${path}`);
});

LSP Diagnostics

Real-time TypeScript/ESLint errors without running commands:

plugin.on('lsp.client.diagnostics', ({ diagnostics }) => {
  const errors = diagnostics.filter(d => d.severity === 'error');
  if (errors.length > 0) {
    showToast(`${errors.length} errors detected`);
  }
});

Native Custom Tools

No need for hooks to add custom commands:

{
  "tools": [
    { "name": "deploy", "command": "npm run deploy" }
  ]
}

UI Events

Programmatic UI control:

plugin.on('tui.toast.show', ({ message, level }) => {
  // Custom toast handling
});

Troubleshooting

Plugin not loading

Check opencode.json exists in project root
Verify plugin is in "plugin" array
Run opencode --debug to see plugin loading logs
Check for syntax errors in opencode.json

Hooks not firing

Verify hook scripts exist and are executable
Check event names match OpenCode’s API
Run opencode --trace-hooks to debug
Ensure hook scripts don’t throw unhandled errors

Custom tools not working

Check tool configuration in opencode.json
Verify command is executable from terminal
Test tool independently: npm test
Check OpenCode logs for execution errors

LSP events not firing

Ensure language server is installed and running
Check .opencode/lsp-config.json configuration
Verify file types are supported by LSP
Run opencode --lsp-debug for diagnostics

Roadmap

Features coming to OpenCode support:

More agents — Porting remaining 1 agent from Claude Code
More commands — Porting remaining 9 commands
More skills — Porting remaining 13 skills
Enhanced LSP integration — Code actions, refactoring support
GitHub Copilot interop — Use both tools simultaneously

Next Steps

Commands

Explore 24 available commands

Custom Tools

Learn to define custom tools

Hook Events

Browse 20+ hook events

Skills

See 37 ported skills

Get Started

Core Concepts

Platform Support

Guides

​Overview

​Feature Parity Table

​Installation

​Option 1: Use Directly

​Option 2: Install as npm Package

​Prerequisites

​Hook Support via Plugins

​Event Mapping

​Additional OpenCode Events

​Hook Examples

​6 Native Custom Tools

run-tests

check-coverage

security-audit

format-code

build-check

dependency-check

​Tool Configuration

​24 Available Commands

​Configuration

​opencode.json Structure

​Usage Examples

​Starting a Feature

​Auto-Formatting Workflow

​Security Audit on Commit

​Documentation

Migration Guide

Plugin README

Consolidated Rules

LLM Documentation

​Best Practices

Leverage Events

Custom Tools

Hook Chaining

LSP Integration

​Feature Comparison

​OpenCode Exclusive Features

​Troubleshooting

​Roadmap

​Next Steps

Commands

Custom Tools

Hook Events

Skills

Overview

Feature Parity Table

Installation

Option 1: Use Directly

Option 2: Install as npm Package

Prerequisites

Hook Support via Plugins

Event Mapping

Additional OpenCode Events

Hook Examples

6 Native Custom Tools

Tool Configuration

24 Available Commands

Configuration

opencode.json Structure

Usage Examples

Starting a Feature

Auto-Formatting Workflow

Security Audit on Commit

Documentation

Best Practices

Feature Comparison

OpenCode Exclusive Features

Troubleshooting

Roadmap

Next Steps