8000 universal-dev-standards/integrations/opencode at main · AsiaOstrich/universal-dev-standards · GitHub
[go: up one dir, main page]
Skip to content

Latest commit

 

History

History

opencode

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
AGENTS.md
AGENTS.md
 
 
README.md
README.md
 
 
opencode.json
opencode.json
 
 
skills-mapping.md
skills-mapping.md
 
 

README.md

OpenCode Integration

Language: English | 繁體中文 | 简体中文

Version: 1.3.0 Last Updated: 2026-01-13

This directory provides resources for integrating Universal Dev Standards with OpenCode.

Overview

Op 8F77 enCode is an open-source AI coding agent that can run as a terminal interface, desktop app, or IDE extension. This integration helps OpenCode understand your project and follow development standards.

Resources

  • AGENTS.md (Required): Project-level rules file, automatically loaded by OpenCode.

  • skills-mapping.md (Reference): Maps all 18 Claude Code skills to OpenCode equivalents.

  • opencode.json (Optional): Configuration example with permission settings and custom agents.

Configuration Levels

OpenCode supports multiple configuration levels:

Type File Location Description
Project Rules AGENTS.md Project root, auto-loaded
Global Rules ~/.config/opencode/AGENTS.md Personal rules for all projects
Project Config opencode.json JSON configuration
Global Config ~/.config/opencode/opencode.json Global JSON config
Custom Agents .opencode/agent/*.md Project-level agents
Global Agents ~/.config/opencode/agent/*.md Global agents

Quick Start

Option 1: Copy Rules File (Recommended)

# Copy to your project root
cp integrations/opencode/AGENTS.md AGENTS.md

# Optional: Copy config file
cp integrations/opencode/opencode.json opencode.json

Option 2: Use curl

curl -o AGENTS.md https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/integrations/opencode/AGENTS.md

Option 3: Use /init (Append Mode)

opencode
/init

Note: /init will append to existing AGENTS.md, not overwrite.

Option 4: Use UDS CLI (Recommended for Skills)

# Install UDS CLI globally
npm install -g universal-dev-standards

# Initialize project - select OpenCode as your AI tool
uds init

# Skills will be installed to .claude/skills/ (auto-detected by OpenCode)

New in v3.5.0: OpenCode is now treated as a skills-compatible tool in the CLI. When only OpenCode (or Claude Code) is selected, minimal installation with skills is automatically offered.

Use uds check to verify your installation status and skills compatibility.

Rules Merging Behavior

OpenCode's rule merging mechanism:

Situation Behavior
/init with existing AGENTS.md Append new content, don't overwrite
Global + Project rules both exist Merge both, project rules take precedence
Config files (opencode.json) Merge, only conflicting keys are overwritten

Configuration Options

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "instructions": ["AGENTS.md", "CONTRIBUTING.md"],
  "permission": {
    "edit": "ask",
    "bash": "ask"
  },
  "agent": {
    "code-reviewer": {
      "description": "Reviews code following standards",
      "mode": "subagent",
      "tools": {"write": false, "edit": false}
    }
  }
}

Key Options:

  • instructions: Reference additional rule files (useful for monorepos)
  • permission: Require user confirmation for edits and bash
  • agent: Define custom agents with specific capabilities

Skills Compatibility

OpenCode is fully compatible with Claude Code skills. All 18 UDS skills work without modification.

Configuration Mapping

Claude Code OpenCode
CLAUDE.md AGENTS.md
.claude/skills/ .opencode/skill/ (also reads .claude/skills/)
settings.json opencode.json

Skills Search Order

OpenCode searches for skills in this order:

  1. .opencode/skill/<name>/SKILL.md (project)
  2. ~/.config/opencode/skill/<name>/SKILL.md (global)
  3. .claude/skills/<name>/SKILL.md (Claude-compatible ✅)

Quick Verification

# Test skill loading in OpenCode
opencode
/commit  # Should load commit-standards skill

For complete skills mapping and installation methods, see skills-mapping.md

Related Standards

Version History

Version Date Changes
1.3.0 2026-01-13 Added UDS CLI installation option; OpenCode now skills-compatible in CLI
1.2.0 2026-01-13 Added skills-mapping.md; simplified README
1.1.0 2026-01-13 Added Claude Code migration guide
1.0.0 2026-01-09 Initial OpenCode integration

License

This document is released under CC BY 4.0.
0