opencode

[!WARNING] 🚨 REPOSITORY ARCHIVED AND MOVED 🚨

This project is now archived and closed. All future development, updates, and content have been moved to a new repository.

Please visit our new home: https://github.com/jjmartres/ai-coding-agents

Table of Contents

• Features
• Documentation
• Prerequisites
• Installation
• Usage
• Configuration Structure
• Development
• Contributing
• License

Features

• 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

Documentation

• 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.

Prerequisites

• 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)

Installing Prerequisites

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

Installation

Quick Start

# 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

What Gets Installed

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/

Installation Methods

The Makefile automatically detects if GNU Stow is available:

• With Stow: Uses stow for proper symlink management
• Without Stow: Falls back to ln -s for direct symlinks

Usage

Basic Commands

# 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

Available Make Targets

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

# 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 + hooks
make uninstall-all         # Remove everything

Configuration Structure

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

Development

Making Changes

1. Edit files in the opencode/ directory
2. Changes are immediately reflected (symlinks!)
3. Restart OpenCode if needed

Running Pre-commit Hooks

# 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"

Updating Configuration

# Pull latest changes
git pull origin main

# Refresh symlinks
make restow

Troubleshooting

Configuration Not Loading

# Check installation status
make status

# Verify symlinks
ls -la ~/.config/opencode/

# Reinstall
make uninstall
make install

Stow Conflicts

# If you get conflicts, remove existing files first
rm -rf ~/.config/opencode/agent  # Repeat for other directories

# Then reinstall
make install

Pre-commit Hooks Failing

# Run hooks manually to see errors
make run-hooks

# Update hooks
make update-hooks

# Uninstall/reinstall hooks
make uninstall-hooks
make install-hooks

Contributing

Contributions 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.

License

MIT License - see LICENSE file for details

Acknowledgments

• OpenCode - The AI-powered code editor
• GNU Stow - Symlink farm manager
• All our contributors

Support

• 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!