Oh-My-OpenCode: Setup Guide and Best Extensions (2026)

Oh-My-OpenCode is a community-driven extension framework for OpenCode, the open-source AI coding agent. It works like Oh-My-Zsh does for the terminal: a plugin manager that adds themes, extensions, and custom commands to your OpenCode setup.

This guide covers installation, the best extensions, and how to customize Oh-My-OpenCode for your workflow.

Quick Answer: Oh-My-OpenCode is a community-driven extension framework for the OpenCode AI coding agent, enhancing it with themes, extensions, custom commands, and improved skill management.

What Is Oh-My-OpenCode?

OpenCode is a terminal-based AI coding agent that supports multiple LLM providers (OpenAI, Anthropic, local models). By itself, it's a capable but minimal tool.

Oh-My-OpenCode adds a layer on top:

• Themes: Visual customization for the terminal interface
• Extensions: Add capabilities like Git integration, project scaffolding, and code analysis
• Custom commands: Define shortcuts for common workflows
• Skill management: Easier installation and switching of SKILL.md skills

It's entirely community-maintained and open-source.

Recommended skills

Open Source README Generator

by Arnstein Larsen

A repo visitor decides in about ten seconds whether your project solves their pr…

$7.99

Skill Safety Scanner

by karim hammoumi

Scan AI agent skill definitions for malicious instructions, prompt injections, a…

$29

readme-generator

by Samuel Rose · 184

Generates a complete, polished README.md by scanning your actual project structu…

Free

Browse all Opencode skills

Installation

Prerequisites: OpenCode must be installed first.

curl -fsSL https://raw.githubusercontent.com/oh-my-opencode/install/main/install.sh | bash

Or with npm:

npm install -g oh-my-opencode

After installation, restart your terminal. Oh-My-OpenCode hooks into your OpenCode configuration automatically.

Configuration

Oh-My-OpenCode uses a .opencodecfg file in your home directory. The main things to configure:

theme: minimal
extensions:
  - git-helper
  - project-scaffold
  - skill-manager
  - code-stats
model_default: claude-sonnet

Choosing a Theme

Available themes include:

• minimal: Clean, low-noise output (recommended)
• detailed: Verbose output with token counts and timing
• hacker: Matrix-style green-on-black (fun but hard to read)
• corporate: Professional formatting for pair-programming sessions

Best Extensions

skill-manager

The most useful extension for developers who work with SKILL.md skills. It adds commands for browsing, installing, and switching skills:

oc skill list           # List installed skills
oc skill search review  # Search available skills
oc skill install <name> # Install a skill
oc skill switch <name>  # Activate a specific skill

This makes it easy to maintain a library of skills for different tasks: a code review skill, a frontend skill, a testing skill, each activated when you need it.

Browse skills compatible with OpenCode on Agensi.

git-helper

Adds Git-aware commands. OpenCode can read your Git history, diff staged changes, and generate commit messages. With the git-helper extension, you also get:

• Automatic branch detection and context
• PR description generation from commits
• Changelog generation for releases

project-scaffold

Generate project structures from descriptions:

oc scaffold "a Next.js app with Tailwind, shadcn/ui, and Supabase auth"

Produces a complete project structure with configuration files, folder structure, and starter components.

code-stats

Tracks your interaction patterns with the AI agent: tokens used, tasks completed, success rate. Useful for optimizing your prompts and understanding which tasks the agent handles best.

Working with SKILL.md Skills

Oh-My-OpenCode's skill management is its standout feature. It bridges the gap between OpenCode's minimal skill support and Claude Code's more mature system.

With the skill-manager extension, you can install skills from multiple sources:

• GitHub: Install directly from a repository
• Agensi: Browse and install curated skills
• Local files: Add skills from your filesystem

The extension handles the file placement and configuration automatically.

Tips for Power Users

Create custom commands: Define aliases for common workflows in your .opencodecfg:

aliases:
  review: "review the staged changes focusing on security and performance"
  test: "write tests for the most recently modified files"
  doc: "generate documentation for the current module"

Use project-specific configs: Drop an .opencodecfg in your project root to override global settings with project-specific themes, extensions, and default skills.

Model switching: Oh-My-OpenCode makes it easy to switch between LLM providers per task:

oc model claude-opus    # Use Claude for complex reasoning
oc model gpt-4o         # Switch to GPT for quick generation
oc model local-llama    # Use a local model for private code

Oh-My-OpenCode vs Vanilla OpenCode

The overhead is minimal. Oh-My-OpenCode adds a few MB and doesn't slow down agent operations. If you use OpenCode regularly, it's worth installing.