Oh My Opencode Installation

Oh My OpenCode Installation

Overview

This skill provides intelligent installation and configuration guidance for OpenCode and the oh-my-opencode harness. It first detects what's already installed and only proceeds with installation if needed.

When to Use

Trigger phrases:

• "oh my opencode installation"

• "Smart installation and configuration for OpenCode with oh-my-opencode harness - "

• First-time setup – When OpenCode and oh-my-opencode need to be installed from scratch

• Reinstall/upgrade – When reinstalling or updating oh-my-opencode to latest version

• Migration – When moving OpenCode configuration to new machine or environment

• Troubleshooting – When installation issues need to be diagnosed and resolved

• Automated setup – When scripting OpenCode and oh-my-opencode installation for CI/CD

• Mixed environments – When OpenCode is installed but oh-my-opencode is not, or vice versa

Detection First

This section covers detection first for the oh-my-opencode-installation skill. Key operations include input validation, core processing, and output verification. Refer to the skill overview for detailed usage instructions.

Step 1: Detect Existing Installation

Check if OpenCode is installed:

# Check OpenCode installation
if command -v opencode &> /dev/null; then
    OPENCODE_VERSION=$(opencode --version 2>/dev/null || echo "unknown")
    echo "✓ OpenCode is already installed: $OPENCODE_VERSION"
    OPENCODE_INSTALLED=true
else
    echo "✗ OpenCode is not installed"
    OPENCODE_INSTALLED=false
fi

Check if oh-my-opencode is installed:

# Check oh-my-opencode installation
if command -v oh-my-opencode &> /dev/null; then
    OMO_VERSION=$(oh-my-opencode --version 2>/dev/null || echo "unknown")
    echo "✓ oh-my-opencode is already installed: $OMO_VERSION"
    OMO_INSTALLED=true
elif npm list -g oh-my-opencode &> /dev/null; then
    OMO_VERSION=$(npm list -g oh-my-opencode --depth=0 2>/dev/null | grep oh-my-opencode || echo "installed")
    echo "✓ oh-my-opencode npm package is installed"
    OMO_INSTALLED=true
else
    echo "✗ oh-my-opencode is not installed"
    OMO_INSTALLED=false
fi

Check Node.js version:

# Verify Node.js requirements
if command -v node &> /dev/null; then
    NODE_VERSION=$(node --version)
    NODE_MAJOR=$(echo $NODE_VERSION | cut -d'.' -f1 | sed 's/v//')
    if [ "$NODE_MAJOR" -ge 18 ]; then
        echo "✓ Node.js version: $NODE_VERSION (meets requirement)"
    else
        echo "✗ Node.js version: $NODE_VERSION (need 18+)"
    fi
else
    echo "✗ Node.js is not installed"
fi

Step 2: Conditional Installation

Only install if detected as missing:

# Installation decision tree
if [ "$OPENCODE_INSTALLED" = true ] && [ "$OMO_INSTALLED" = true ]; then
    echo "✓ Both OpenCode and oh-my-opencode are installed. Skipping installation."
    echo "Run 'opencode' to start or 'oh-my-opencode --help' for options."
elif [ "$OPENCODE_INSTALLED" = true ]; then
    echo "→ OpenCode is installed. Installing oh-my-opencode only..."
    install_oh_my_opencode
elif [ "$OMO_INSTALLED" = true ]; then
    echo "→ oh-my-opencode is installed. Installing OpenCode only..."
    install_opencode
else
    echo "→ Neither is installed. Installing both..."
    install_opencode
    install_oh_my_opencode
fi

Prerequisites

This section covers prerequisites for the oh-my-opencode-installation skill. Key operations include input validation, core processing, and output verification. Refer to the skill overview for detailed usage instructions.

System Requirements

• Platform: macOS, Linux, Windows (WSL recommended)
• Terminal: WezTerm, Alacritty, Ghostty, or Kitty
• Node.js: Version 18+ (required for oh-my-opencode)
• API Keys: For LLM providers you want to use

Recommended Setup

• Terminal: WezTerm (cross-platform, excellent performance)
• Shell: zsh or bash with oh-my-zsh
• Git: Latest version with proper configuration

Installation Functions

This section covers installation functions for the oh-my-opencode-installation skill. Key operations include input validation, core processing, and output verification. Refer to the skill overview for detailed usage instructions.

install_opencode()

install_opencode() {
    echo "Installing OpenCode..."

    # Detect OS
    if [[ "$OSTYPE" == "darwin"* ]]; then
        # macOS
        if command -v brew &> /dev/null; then
            brew install anomalyco/tap/opencode
        else
            curl -fsSL https://opencode.ai/install | bash
        fi
    elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
        if command -v pacman &> /dev/null; then
            sudo pacman -S opencode
        elif command -v apt &> /dev/null; then
            curl -fsSL https://opencode.ai/install | bash
        else
            curl -fsSL https://opencode.ai/install | bash
        fi
    else
        # Windows or other
        curl -fsSL https://opencode.ai/install | bash
    fi

    # Verify installation
    if command -v opencode &> /dev/null; then
        echo "✓ OpenCode installed successfully: $(opencode --version)"
    else
        echo "✗ OpenCode installation failed"
        return 1
    fi
}

install_oh_my_opencode()

install_oh_my_opencode() {
    echo "Installing oh-my-opencode..."

    # Check Node.js
    if ! command -v node &> /dev/null; then
        echo "✗ Node.js is required but not installed. Please install Node.js 18+ first."
        return 1
    fi

    # Check Node.js version
    NODE_MAJOR=$(node --version | cut -d'.' -f1 | sed 's/v//')
    if [ "$NODE_MAJOR" -lt 18 ]; then
        echo "✗ Node.js 18+ is required. Current version: $(node --version)"
        return 1
    fi

    # Check if npm is available
    if ! command -v npm &> /dev/null; then
        echo "✗ npm is required but not installed."
        return 1
    fi

    # Install via npm
    echo "Installing oh-my-opencode via npm..."
    npm install -g oh-my-opencode

    # Verify installation
    if command -v oh-my-opencode &> /dev/null; then
        echo "✓ oh-my-opencode installed successfully: $(oh-my-opencode --version)"
    else
        echo "✗ oh-my-opencode installation failed"
        return 1
    fi
}

full_installation()

full_installation() {
    echo "========================================="
    echo "Oh My OpenCode Smart Installation"
    echo "========================================="

    # Detection phase
    echo ""
    echo "Phase 1: Detection"
    echo "------------------"
    detect_installation

    # Installation phase
    echo ""
    echo "Phase 2: Installation"
    echo "---------------------"
    install_if_needed

    # Configuration phase
    echo ""
    echo "Phase 3: Configuration"
    echo "----------------------"
    configure_installation

    # Verification phase
    echo ""
    echo "Phase 4: Verification"
    echo "---------------------"
    verify_installation

    echo ""
    echo "========================================="
    echo "Installation Complete!"
    echo "========================================="
}

Installation Methods

This section covers installation methods for the oh-my-opencode-installation skill. Key operations include input validation, core processing, and output verification. Refer to the skill overview for detailed usage instructions.

Method 1: Quick Install (Recommended)

For humans:

# Detection + Installation in one command
curl -fsSL https://opencode.ai/install | bash

# Then install oh-my-opencode
npm install -g oh-my-opencode

Method 2: Node.js Installation

# npm
npm install -g opencode-ai oh-my-opencode

# Bun
bun install -g opencode-ai oh-my-opencode

# pnpm
pnpm install -g opencode-ai oh-my-opencode

Method 3: Homebrew (macOS)

brew install anomalyco/tap/opencode
npm install -g oh-my-opencode

Method 4: For LLM Agents

# Detection + Installation
bash -c "$(curl -fsSL https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.sh)"

Configuration

{
  "enabled": true,
  "autoRun": false,
  "timeout": 30000,
  "retries": 3
}

Set environment variables as needed for authentication and endpoints.

Initial Setup After Installation

1. Verify installation worked:

   opencode --version
   oh-my-opencode --version
   

2. Initialize a project:

   cd /path/to/project
   opencode
   /init
   

3. Configure LLM provider:

   /connect
   

4. Configure oh-my-opencode:

   oh-my-opencode install
   

Config File Locations

Basic Configuration

{
  "plugin": ["oh-my-opencode"],
  "model": {
    "main": "openai/gpt-4o",
    "fallback": ["anthropic/claude-3-5-sonnet-20241022"]
  }
}

Verification

This section covers verification for the oh-my-opencode-installation skill. Key operations include input validation, core processing, and output verification. Refer to the skill overview for detailed usage instructions.

Quick Verification Checklist

# 1. Check versions
opencode --version && echo "✓ OpenCode OK"
oh-my-opencode --version && echo "✓ oh-my-opencode OK"

# 2. Test OpenCode starts
opencode --help > /dev/null 2>&1 && echo "✓ OpenCode CLI OK"

# 3. Check config exists
[ -f ~/.config/opencode/opencode.json ] && echo "✓ Config OK"

# 4. Verify Node.js (for oh-my-opencode)
node --version && echo "✓ Node.js OK"
npm --version && echo "✓ npm OK"

Test Basic Functionality

# Start OpenCode and run basic commands
opencode --eval "/help"

# Check agent availability
opencode --eval "/status"

Integration with OpenClaw

• Connects with existing toolchain via standard interfaces
• Supports webhook-based event notifications
• Compatible with CI/CD pipelines for automated workflows
• Provides structured output for downstream consumption

For OpenClaw Integration

# 1. Verify OpenCode is in PATH
which opencode && echo "✓ OpenCode in PATH"

# 2. Configure OpenClaw
mkdir -p ~/.config/opencode

# 3. Copy oh-my-opencode config
cat > ~/.config/opencode/oh-my-opencode.jsonc << 'EOF'
{
  "agents": {
    "sisyphus": { "model": "openai/gpt-4o" },
    "hephaestus": { "model": "openai/gpt-4o" },
    "oracle": { "model": "anthropic/claude-3-5-sonnet-20241022" }
  }
}
EOF

# 4. Load oh-my-opencode skill in OpenClaw
echo "✓ OpenClaw integration configured"

Troubleshooting

Detection Issues

"Command not found" after installation:

# Reload shell
exec $SHELL

# Or add to PATH manually
export PATH="/usr/local/bin:$PATH"

# Verify installation
ls -la /usr/local/bin/opencode
ls -la /usr/local/bin/oh-my-opencode

Wrong version detected:

# Check exact installation
which -a opencode
which -a oh-my-opencode

# Check npm global
npm list -g --depth=0

Installation Issues

npm install fails:

# Clear npm cache
npm cache clean --force

# Check npm permissions
npm config get prefix

# Fix permissions if needed
sudo chown -R $(whoami) ~/.npm

Permission denied:

# Use sudo for system-wide install
sudo npm install -g oh-my-opencode

# Or use nvm for local installation
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
nvm use 18
npm install -g oh-my-opencode

Configuration Issues

Config not loading:

# Check config syntax
cat ~/.config/opencode/opencode.jsonc | python3 -m json.tool > /dev/null && echo "✓ Config valid"

# Check config location
ls -la ~/.config/opencode/

# View config errors
opencode --debug config

Security Considerations

This section covers security considerations for the oh-my-opencode-installation skill. Key operations include input validation, core processing, and output verification. Refer to the skill overview for detailed usage instructions.

Safe Installation

• ✓ Download from official sources only
• ✓ Verify checksums when available
• ✓ Review installation scripts
• ✓ Use environment variables for API keys
• ✓ Set restrictive file permissions (600 for configs)

Security Checks

# Verify download source
echo "Checking installation sources..."

# OpenCode
[ "$(curl -sI https://opencode.ai/install | head -1)" =~ "200" ] && echo "✓ OpenCode source OK"

# oh-my-opencode npm package
npm view oh-my-opencode version && echo "✓ npm package verified"

Post-Installation Checklist

• OpenCode installed and opencode --version works
• oh-my-opencode installed and oh-my-opencode --version works
• Node.js 18+ installed (check with node --version)
• npm installed (check with npm --version)
• LLM provider configured (run /connect in OpenCode)
• Config files created at ~/.config/opencode/
• Test a basic command in OpenCode
• Load oh-my-opencode skill in OpenClaw

Quick Reference

The Process

1. Detect existing installation – Check if OpenCode and oh-my-opencode are already installed (skip steps if found)
2. Verify prerequisites – Ensure Node.js 18+ is installed, check npm availability
3. Choose installation method – Select one: Humans (curl script), LLM Agents (bash script), or Manual (curl + npm)
4. Execute installation – Run chosen method and verify output shows success
5. Configure – Set up configuration file at project-level or user-level
6. Verify – Run opencode --version and oh-my-opencode --version to confirm both install
7. Test agents – Run /agent sisyphus or /agent hephaestus to verify agents load
8. Initialize project – Run /init inside OpenCode to create AGENTS.md

When NOT to Use

• Task is outside your authorization scope
• You need to implement controls (use implementing-* skills)
• Task is about analysis, not action (use analyzing-* skills)
• You don't have access to target systems
• Task requires compliance expertise (consult professionals)
• Task is about defense, not offense (use defensive skills)

Red Flags

• Installing without checking – Not running detection first causing duplicate installs or conflicts
• Wrong Node.js version – Installing on Node.js < 18 causing runtime errors
• Permission denied – Installing globally without proper permissions, or trying to install system-wide without sudo
• Mixing installation methods – Using curl for OpenCode but npm for oh-my-opencode causing version mismatch
• Skipping verification – proceeding to use OpenCode without confirming version output
• Network failures – Assuming installation succeeded without checking network connectivity
• Config not created – Trying to use oh-my-opencode without creating configuration file first

Verification

• Version commands work: opencode --version shows version, oh-my-opencode --version shows version
• Agents load: /agent command switches to sisyphus, hephaestus, oracle, librarian, explore without errors
• Config loads: Configuration file is found at project/user level, values returned via config get
• Hooks working: Hook commands execute at expected times without errors
• MCPs respond: MCP servers installed and responding to tool calls
• Project init works: /init creates AGENTS.md in project root
• No errors in logs: opencode logs shows no installation errors or warnings

References

• OpenCode Docs: https://opencode.ai/docs/
• Oh My OpenCode: https://github.com/code-yeongyu/oh-my-opencode
• Installation Guide: https://github.com/code-yeongyu/oh-my-opencode/blob/master/docs/guide/installation.md

Anti-Rationalization Table

Related Skills

• oh-my-opencode: Overall integration
• oh-my-opencode-agents: Agent usage guide
• oh-my-opencode-usage: Daily usage patterns
• oh-my-opencode-configuration: Advanced configuration

Process

1. Analyze the task requirements
2. Apply domain expertise
3. Verify output quality