Master of OpenCode — Ruler of the OpenCode realm
OpenZeus is an advanced AI agent for OpenCode that provides comprehensive system-level operations, documentation management, and autonomous configuration management. Built with extensive skills, agents, and commands for optimal OpenCode workflow orchestration.
- 🏛️ Master Agent: Comprehensive OpenCode knowledge and operation
- 🛠️ 15 Zeus Skills: Specialized skill bundles for different domains
- ⚡ Smart Commands: Custom commands for common workflows
- 🔄 Bidirectional Sync: Automatic sync between repo and OpenCode config
- 📚 Documentation Cache: Offline OpenCode documentation access
- 🔧 Self-Optimization: Continuous performance monitoring and improvement
- 🎯 Proactive Intelligence: Auto-detection of user intent and skill loading
# Install globally with npm
npm install -g openzeus
# Or with bun (when available)
bun install -g openzeus# Clone repository
git clone https://github.com/Aveer/OpenZeus.git
cd OpenZeus
# Run installer
./scripts/install.shAdd to your ~/.config/opencode/opencode.json:
{
"default_agent": "OpenZeus"
}@OpenZeus help me configure OpenCode for my project
@OpenZeus create a new skill for Docker management
@OpenZeus show me system health and performanceSkills load automatically based on context:
@OpenZeus I need help with Docker containers
# → Automatically loads zeus-docker skill
@OpenZeus create a new agent for my project
# → Loads zeus-agents + zeus-core skills/zeus-kanban # Project kanban board
/zeus-git-commit # Smart git commit helper
/zeus-roadmap # Generate project roadmap
/zeus-improve-project # Project improvement suggestionsOpenZeus provides 15 specialized knowledge bundles organized into categories:
| Skill | Purpose |
|---|---|
zeus-core |
Complete OpenCode reference - paths, configs, schemas, troubleshooting |
zeus-docker |
Docker and containerization expertise with examples and best practices |
zeus-sql |
Database operations, SQL queries, schema design, and ORM patterns |
zeus-llm |
Local LLM setup - llama.cpp, llama-swap, Ollama |
| Skill | Purpose |
|---|---|
zeus-agents |
Agent creation templates, permissions, and workflow patterns |
zeus-commands |
Custom command creation - prompts, templates, and OpenCode integration |
zeus-skills |
Skill bundle creation guide with structure and best practices |
zeus-context |
Context management, compression strategies, and conversation optimization |
| Skill | Purpose |
|---|---|
zeus-self |
Runtime introspection - health checks, performance analysis, session diagnostics |
zeus-upskill |
Self-improvement - learns new skills, updates capabilities, extends knowledge |
Documentation and integration guides for external tools and OpenCode plugins:
| Skill | Tool/Plugin | Repository |
|---|---|---|
zeus-swarm |
opencode-swarm | Multi-agent orchestration |
zeus-omo |
oh-my-opencode-slim | Terminal integration |
zeus-beads |
Beads issue tracker | Steve Yegge's Beads |
zeus-oac |
OpenAgentsControl | Plan-first development |
Playful and experimental skills for testing and enjoyment:
| Skill | Purpose | Description |
|---|---|---|
zeus-boston-terrier |
Boston Terrier dogs | Breed info, care, temperament, and history |
OpenZeus automatically loads appropriate skills based on your intent:
| When you say... | OpenZeus loads... |
|---|---|
| "config", "opencode.json" | zeus-core |
| "create agent" | zeus-agents + zeus-core |
| "create command" | zeus-commands + zeus-core |
| "docker", "container" | zeus-docker + zeus-core |
| "analyze self", "optimize" | zeus-self + zeus-context |
@OpenZeus create a new agent called "DataAnalyst" that specializes in SQL queries and data visualization
# → Creates agent with proper permissions and skills
# → Available immediately in OpenCode@OpenZeus create a skill for AWS management with EC2, S3, and Lambda operations
# → Creates zeus-aws skill bundle
# → Adds to OpenZeus skill loading guide automatically@OpenZeus check your system health and performance
# → Loads zeus-self skill
# → Runs comprehensive diagnostics
# → Reports configuration, capabilities, context health@OpenZeus help me containerize this Node.js application
# → Auto-loads zeus-docker skill
# → Creates Dockerfile, docker-compose.yml
# → Provides deployment instructions@OpenZeus configure OpenCode for my React project with TypeScript
# → Loads zeus-core skill
# → Sets up proper model, permissions, tools
# → Configures project-specific settingsJust ask OpenZeus:
@OpenZeus create a skill for [your topic]OpenZeus will handle the creation, registration, and sync automatically.
# Test installation locally
npm pack
npm install -g openzeus-1.0.4.tgz
# Verify OpenZeus is available
@OpenZeus self- Fork the repository
- Create feature branch:
git checkout -b feature/my-feature - Make changes and test thoroughly
- Run sync:
./scripts/sync-utils.sh push - Commit:
git commit -am 'Add my feature' - Push:
git push origin feature/my-feature - Create Pull Request
| Issue | Solution |
|---|---|
OpenZeus not available |
Run npm install -g openzeus and restart OpenCode |
Skills not loading |
Restart OpenCode or check ~/.config/opencode/skills/zeus-* |
Config not found |
Install OpenCode first: https://opencode.ai/docs/ |
@OpenZeus not responding |
Add "default_agent": "OpenZeus" to opencode.json |
MIT License - see LICENSE file for details.
- Repository: https://github.com/Aveer/OpenZeus
- Issues: https://github.com/Aveer/OpenZeus/issues
- OpenCode Docs: https://opencode.ai/docs/
- NPM Package: https://npmjs.com/package/openzeus
🏛️ Welcome to the realm of OpenZeus!