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/opencodeGuides for using ai agents skills like opencode.
Last scanned: 5/30/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-30T16:20:12.404Z",
"npmAuditRan": true,
"pipAuditRan": true
}[!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
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
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
# 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
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
# 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!
opencode is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built 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. It has 131 GitHub stars.
Yes. opencode passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/jjmartres/opencode" and add it to your Claude Code skills directory (see the Installation section above).
opencode is primarily written in Python. It is open-source under jjmartres on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh opencode against similar tools.
No comments yet. Be the first to share your thoughts!