What is Oh-My-OpenCode used for with OpenCode?

Oh-My-OpenCode is a community-driven extension framework for OpenCode, the open-source AI coding agent. It enhances OpenCode by adding themes for visual customization, extensions for new capabilities like Git integration and code analysis, custom commands to define shortcuts for common workflows, and improved skill management for easier installation and switching of SKILL.md skills.

What are the prerequisites for installing Oh-My-OpenCode?

The primary prerequisite for installing Oh-My-OpenCode is that OpenCode itself must already be installed on your system. Once OpenCode is set up, you can proceed with Oh-My-OpenCode installation using either a curl command for direct download and execution of the install script or by using npm to globally install the package.

Which file is used for configuring Oh-My-OpenCode?

Oh-My-OpenCode uses a configuration file named `.opencodecfg` which is located in your home directory. This YAML-formatted file allows you to customize various aspects of Oh-My-OpenCode, including selecting a theme, enabling or disabling extensions, setting a default model, and defining custom aliases for commands.

What does the skill-manager extension provide to OpenCode users?

The skill-manager extension is a highly useful tool for developers working with SKILL.md skills. It adds commands to OpenCode for easily browsing, installing, and switching between different skills. This allows users to maintain a curated library of skills for diverse tasks, such as code review, front-end development, or testing, and activate them only when needed for specific projects or tasks.

How can users define custom commands in Oh-My-OpenCode?

Users can define custom commands, also known as aliases, in Oh-My-OpenCode by adding them to the `aliases` section within their `.opencodecfg` file. This feature allows users to create shortcuts for common or complex workflows, such as 'review' to review staged changes focusing on security, 'test' to write tests for modified files, or 'doc' to generate documentation for a current module.

Oh-My-OpenCode: Setup, Extensions, and Configuration (2026)

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

Published: June 14, 2026

Category: Guides

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.

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

| Feature | Vanilla OpenCode | With Oh-My-OpenCode |
|---|---|---|
| Themes | None | Multiple options |
| Skill management | Manual file placement | Install/search/switch commands |
| Git integration | Basic | Enhanced with git-helper |
| Custom commands | None | Aliases and workflows |
| Model switching | Config file edit | CLI command |

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.