OpenCode Installation Guide

Prerequisites

• OpenCode.ai installed
• Git installed

Installation Steps

Option 1: Let OpenCode Install Automatically (Recommended)

Tell OpenCode:

Clone https://github.com/obra/superpowers to ~/.config/opencode/superpowers, then create directory ~/.config/opencode/plugins, then symlink ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js to ~/.config/opencode/plugins/superpowers.js, then symlink ~/.config/opencode/superpowers/skills to ~/.config/opencode/skills/superpowers, then restart opencode.

Option 2: Manual Installation (macOS / Linux)

# 1. Clone the repository
git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers

# 2. Create directories
mkdir -p ~/.config/opencode/plugins ~/.config/opencode/skills

# 3. Create plugin symlink
ln -s ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js ~/.config/opencode/plugins/superpowers.js

# 4. Create skills symlink
ln -s ~/.config/opencode/superpowers/skills ~/.config/opencode/skills/superpowers

# 5. Restart OpenCode

Manual Installation (Windows PowerShell)

Prerequisites: Developer Mode enabled OR run as Administrator

# 1. Clone the repository
git clone https://github.com/obra/superpowers.git "$env:USERPROFILE\.config\opencode\superpowers"

# 2. Create directories
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\opencode\plugins"
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\opencode\skills"

# 3. Create plugin symlink (requires Admin or Developer Mode)
New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.config\opencode\plugins\superpowers.js" -Target "$env:USERPROFILE\.config\opencode\superpowers\.opencode\plugins\superpowers.js"

# 4. Create skills junction (no special privileges needed)
New-Item -ItemType Junction -Path "$env:USERPROFILE\.config\opencode\skills\superpowers" -Target "$env:USERPROFILE\.config\opencode\superpowers\skills"

# 5. Restart OpenCode

How It Works

OpenCode has native skill discovery. At startup, it scans these locations:

1. Project skills (.opencode/skills/) - Highest priority
2. Personal skills (~/.config/opencode/skills/)
3. Superpowers skills (~/.config/opencode/skills/superpowers/) - via symlink

The plugin automatically injects Superpowers context into the system prompt.

Verify Installation

macOS / Linux:

ls -l ~/.config/opencode/plugins/superpowers.js
ls -l ~/.config/opencode/skills/superpowers

Windows:

Get-ChildItem "$env:USERPROFILE\.config\opencode\plugins" | Where-Object { $_.LinkType }
Get-ChildItem "$env:USERPROFILE\.config\opencode\skills" | Where-Object { $_.LinkType }

Or ask OpenCode: "do you have superpowers?"

Usage

List Available Skills

use skill tool to list skills

Load a Specific Skill

use skill tool to load superpowers/brainstorming

Configuration File Locations

• Superpowers directory: ~/.config/opencode/superpowers/
• Plugin link: ~/.config/opencode/plugins/superpowers.js
• Skills link: ~/.config/opencode/skills/superpowers/
• Personal skills: ~/.config/opencode/skills/
• Project skills: .opencode/skills/

Updating

cd ~/.config/opencode/superpowers && git pull

Restart OpenCode to load updates.

Troubleshooting

Plugin not loading

1. Check the plugin symlink is correct
2. Check source file exists: ls ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js
3. Restart OpenCode

Skills not found

1. Check skills symlink: ls -l ~/.config/opencode/skills/superpowers
2. Use the skill tool to list available skills

Windows permission issues

• Enable Developer Mode: Settings → Update & Security → For developers
• Or run terminal as Administrator

Tool Mapping

When skills reference Claude Code tools:

• TodoWrite → todowrite
• Task with subagents → OpenCode's @mention syntax
• Skill tool → OpenCode's native skill tool