Jumpstart your Opencode environment with this pre-built configuration. It includes a variety of agents, commands, skills, themes and MCP servers definitions, all ready for you to use and customize. Spend less time configuring and more time automating.
- Features
- Documentation
- Prerequisites
- Installation
- Usage
- Configuration Structure
- Development
- Superpowers Extension
- Contributing
- License
- Agents: Specialized AI agents for various domains (payment integration, customer success, etc.)
- Skills: Reusable skill definitions for common workflows
- MCP Servers: Model Context Protocol server configurations
- Rules: Coding rules and best practices
- Themes: Custom themes for OpenCode
- Automated Installation: Uses GNU Stow or symlinks for easy deployment
- Pre-commit Hooks: Automatic validation and linting
- Agents: Detailed list of all available AI agents.
- Commands: Comprehensive list of all available commands.
- Skills: Detailed list of all available skills.
- Rules: Coding rules and best practices.
- OpenCode - AI-powered code editor
- GNU Stow - Symlink farm manager (optional but recommended)
- Node.js - JavaScript runtime (v18+)
- Git - Version control
- pre-commit - Git hook framework (optional)
macOS:
brew install stow node pre-commitUbuntu/Debian:
sudo apt install stow nodejs npm
pip install pre-commitArch Linux:
sudo pacman -S stow nodejs npm python-pre-commitUbuntu/Debian:
sudo apt install stow nodejs npm
pip install pre-commitArch Linux:
sudo pacman -S stow nodejs npm python-pre-commit# Clone the repository
git clone https://github.com/jjmartres/opencode.git
cd opencode
# Install configuration
make install
# (Optional) Install pre-commit hooks
make install-hooks
# (Optional) Install Superpowers extension
make install-superpowersThe installation process creates symlinks from this repository to ~/.config/opencode/:
~/.config/opencode/
├── agent/ -> ~/opencode/opencode/agent/
├── command/ -> ~/opencode/opencode/command/
├── mcp/ -> ~/opencode/opencode/mcp/
├── plugin/ -> ~/opencode/opencode/plugin/
├── rules/ -> ~/opencode/opencode/rules/
├── skill/ -> ~/opencode/opencode/skill/
└── themes/ -> ~/opencode/opencode/themes/
The Makefile automatically detects if GNU Stow is available:
- With Stow: Uses
stowfor proper symlink management - Without Stow: Falls back to
ln -sfor direct symlinks
# Open current directory in OpenCode
opencode .
# Open specific file
opencode path/to/file.py
# Check installation status
make status
# List available packages
make list
# Update configuration (after pulling changes)
make restowmake help # Display all available commands
make install # Install OpenCode configuration
make uninstall # Remove configuration symlinks
make restow # Refresh symlinks (after updates)
make status # Show installation status
make list # List available packages
make clean # Remove broken symlinks
# Superpowers Extension
make install-superpowers # Install obra's superpowers
make update-superpowers # Update superpowers to latest
make uninstall-superpowers # Remove superpowers
make superpowers-status # Check superpowers installation
# Pre-commit Hooks
make install-hooks # Install pre-commit hooks
make run-hooks # Run hooks manually
make update-hooks # Update hooks to latest versions
# Combined Operations
make install-all # Install config + superpowers
make uninstall-all # Remove everythingopencode/
├── agent/ # AI agent definitions
│ ├── 01-core/
│ ├── 02-languages/
│ ├── 03-infrastructure/
│ ├── 04-quality-and-security/
│ ├── 05-data-ai/
│ ├── 06-developer-experience/
│ ├── 07-specialized-domains/
│ ├── 08-business-product/
│ ├── 09-meta-orchestration/
│ └── 10-curiosity/
├── command/ # Custom commands
├── mcp/ # MCP server configurations
├── rules/ # Coding rules and standards
├── skill/ # Reusable skills
│ ├── mcp-builder/
│ ├── content-research-writer/
│ └── meeting-insights-analyzer/
└── themes/ # UI themes
- Edit files in the
opencode/directory - Changes are immediately reflected (symlinks!)
- Restart OpenCode if needed
# Run all hooks on all files
make run-hooks
# Run specific hook
pre-commit run markdownlint --all-files
# Skip hooks for a commit (not recommended)
git commit --no-verify -m "message"# Pull latest changes
git pull origin main
# Refresh symlinks
make restowSuperpowers is a powerful extension that enhances OpenCode with additional capabilities.
make install-superpowersThis clones the superpowers repository to ~/.config/opencode/superpowers and automatically adds it to .gitignore to prevent accidental commits.
# Update to latest version
make update-superpowers
# Check current status
make superpowers-statusFor detailed installation instructions, see the official INSTALL guide.
# Check installation status
make status
# Verify symlinks
ls -la ~/.config/opencode/
# Reinstall
make uninstall
make install# If you get conflicts, remove existing files first
rm -rf ~/.config/opencode/agent # Repeat for other directories
# Then reinstall
make install# Run hooks manually to see errors
make run-hooks
# Update hooks
make update-hooks
# Uninstall/reinstall hooks
make uninstall-hooks
make install-hooksContributions are welcome! We appreciate bug reports, feature suggestions, new agents/skills, and documentation improvements.
Please read our Contributing Guidelines for:
- How to report bugs
- How to suggest enhancements
- Development workflow and pull request process
- Coding standards and pre-commit requirements
- Testing procedures
Quick Start for Contributors:
# Fork and clone
git clone https://github.com/YOUR_USERNAME/opencode.git
cd opencode
# Install with development hooks
make install
make install-hooks
# Make changes and test
make run-hooks
make status
# Submit a pull request!For detailed contribution guidelines, see CONTRIBUTING.md.
MIT License - see LICENSE file for details
- OpenCode - The AI-powered code editor
- Superpowers - Extension by obra
- GNU Stow - Symlink farm manager
- All our contributors
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Contributing: See CONTRIBUTING.md
Note: This configuration is tailored for personal use. Feel free to fork and customize for your needs!