by jjmartres
A powerful, custom opencode configuration, complete with a suite of agents, commands, rules, skills, and a pre-configured MCP server. It's designed to be a flexible starting point for you to build upon and adapt.
# Add to your Claude Code skills
git clone https://github.com/jjmartres/opencodeNo comments yet. Be the first to share your thoughts!
macOS:
brew install stow node pre-commit
Ubuntu/Debian:
sudo apt install stow nodejs npm
pip install pre-commit
Arch Linux:
sudo pacman -S stow nodejs npm python-pre-commit
Ubuntu/Debian:
sudo apt install stow nodejs npm
pip install pre-commit
Arch 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-superpowers
The 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:
stow for proper symlink managementln -s for 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 restow
make 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 everything
opencode/
├── 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
opencode/ directory# 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 restow
Superpowers is a powerful extension that enhances OpenCode with additional capabilities.
make install-superpowers
This 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-status
For 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-hooks
Contributions are welcome! We appreciate bug reports, feature suggestions, new agents/skills, and documentation improvements.
Please read our Contributing Guidelines for:
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
Note: This configuration is tailored for personal use. Feel free to fork and customize for your needs!