opencode-supreme-setup

KO | EN

gitlite — search

#python #ai #typescript #api #react #llm #mcp #android #openai #home-assistant #react-native #axios

opencode-supreme-setup

★ 47 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# OpenCode Supreme Setup

> **From zero to 480+ skills, 11 sub-agents, Team Mode, and Caveman efficiency — in one command.**

## Quick Install

```powershell
# Windows (PowerShell 7+)
irm https://raw.githubusercontent.com/skeletorflet/opencode-supreme-setup/master/install.ps1 | iex
```

```bash
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/skeletorflet/opencode-supreme-setup/master/install.sh | bash
```

```bash
# Or clone
git clone https://github.com/skeletorflet/opencode-supreme-setup.git && cd opencode-supreme-setup
# Windows: .\install.ps1   |   Linux/macOS: chmod +x install.sh && ./install.sh
```

![OpenCode Supreme Setup Banner](https://github.com/skeletorflet/opencode-supreme-setup/blob/master/banner.webp?raw=true)

---

## What You Get

| Category | Included |
|----------|----------|
| **Agent Orchestration** | oh-my-openagent — Sisyphus loops, Team Mode (8 parallel), 11 sub-agents |
| **Team Mode** | 8 max parallel members, team task system, team messaging |
| **Caveman Mode** | Ultra-efficient AGENTS.md — zero fluff, surgical AST/LSP edits, English-only output |
| **Custom Agents** | `caveman`, `spec-architect`, `self-healer`, `security-auditor`, `docs-writer`, `refactor`, `speckit` |
| **Sub-Agents** | `sisyphus`, `oracle`, `librarian`, `explore`, `multimodal-looker`, `prometheus`, `metis`, `momus`, `atlas`, `sisyphus-junior`, `hephaestus` |
| **Agent Categories** | visual-engineering, ultrabrain, deep, artistry, quick, unspecified-low, unspecified-high, writing |
| **Skills** | 480+ across 3 sources (marketplace CKMs + agent skills + project presets) |
| **Plugins** | 13 plugins — snippets, snip, notify, mem, quota, background-agents, worktree, context-pruning, smart-title, ocwatch, superpowers, supermemory, oh-my-openagent |
| **MCP Servers** | web-search (Tavily), pdf-reader, google-drive, memory-plus, codegraph |
| **Memory** | opencode-mem (vector-DB, web UI localhost:4747) + supermemory (cross-session knowledge) |
| **Token Savings** | `snip` CLI — filters shell output, 60-90% fewer tokens |
| **Model** | 100% `opencode-go/deepseek-v4-flash` across all agents + fallbacks |
| **Optimizations** | Hashline edits, runtime fallback (auto-retry 400/429/503/529), dynamic context pruning (dedup, supersede writes, purge errors), auto-resume, aggressive truncation, streaming tools |

## Prerequisites

- **Node.js** 18+ • **Bun** 1.x (auto-installed) • **PowerShell 7+** or **bash 4+**

## Default Model Configuration

All agents are pre-configured with **`opencode-go/deepseek-v4-flash`** — a cost-efficient model that consumes very few tokens per session, making it ideal for the agent-heavy workflows in this setup.

> To change the model or provider, edit `%userprofile%\.config\opencode\oh-my-openagent.json` and update the `model` field for any agent or category.

## What Gets Installed

The installer runs 10 automated steps (Turbo Installer v3):

| Step | What |
|------|------|
| 1 | Prerequisites (Node.js, PowerShell 7+ / Bash 4+) |
| 2 | Mass NPM Ecosystem — 15 packages in one batch (opencode-ai, bun, openskills, 12 plugins, dev tools) |
| 3 | Spec-kit CLI — Spec-Driven Development toolkit (via uv or npm) |
| 4 | oh-my-openagent — agent orchestration, sub-agents, Team Mode, MCPs |
| 5 | GitHub CLI (via winget/brew/apt) |
| 6 | OpenSkills repositories — anthropics/skills, mattpocock/skills, caveman, graphify, open-design |
| 7 | YAML Patch — fixes open-design-landing SKILL.md syntax |
| 8 | Config Sync — copies opencode.json, oh-my-openagent.json, AGENTS.md, codegraph skill |
| 9 | SpecKit Agent injection — adds unified speckit agent to opencode.json |
| 10 | CodeGraph init & oh-my-openagent doctor health check |

Agent ecosystem is finalized in `opencode.json` with 7 custom agents registered (caveman, speckit, self-healer, security-auditor, refactor, docs-writer, spec-architect) and oh-my-openagent provides 11 sub-agents (sisyphus, oracle, librarian, explore, multimodal-looker, prometheus, metis, momus, atlas, sisyphus-junior, hephaestus).

## Skills

### 480+ Unique Skills

Skills are aggregated from 3 sources:

| Source | Count | Notes |
|--------|-------|-------|
| `~/.config/opencode/skills/` | ~137 | Built-in opencode skills + synced reference presets |
| `~/.agents/skills/` | 9 | build-your-own-x, compress, find-skills, skill-sync |
| `.claude/skills/` (project) | 335 | Marketplace CKMs, community plugins, creative tools, templates |

The ecosystem badge displays 480+ accounting for all marketplace skills from Anthropic's ecosystem, community contributions, and project presets combined.

**Categories include:**

| Category | Skills |
|----------|--------|
| **Frontend** | angular, astro, gatsby, gsap, htmx, motion-framer, nextjs, nuxt, svelte, tailwind, threejs, vue |
| **Backend** | actix-web, aspnet-core, bun, django, elysia, express, fastapi, fastify, fiber, flask, gin, hono, koa, laravel, nestjs, rails |
| **Languages** | dart, deno, elixir, go-lang, kotlin, rust, solidjs, swift, zig |
| **Mobile/Desktop** | electron, flutter, react-native, tauri |
| **Databases** | drizzle, mongodb, postgresql, prisma, redis, sqlite, supabase |
| **AI/ML** | crewai, huggingface, langchain, ollama, pytorch, tensorflow |
| **DevOps** | ansible, github-actions, helm, kubernetes, pulumi, terraform |
| **Design** | d3js, material-ui, shadcn, ui-styling, ui-ux-pro-max, banner-design, brand, design |
| **Creative** | hyperframes, algorithmic-art, canvas-design, sprite-animation, shader-dev, hand-drawn-diagrams |
| **HTML Decks (50+)** | html-ppt, kami-deck, deck-swiss-international, guizang-ppt, 40+ Zhangzara templates |
| **Media** | fal-generate, fal-3d, fal-video-edit, imagem, sora, replicate, venice-* |
| **Methodology** | brainstorming, TDD, diagnose, systematic-debugging, review, verification-before-completion |
| **Workflow** | superpowers (dispatching-parallel-agents, executing-plans, writing-plans, subagent-driven-development, finishing-a-development-branch) |

Use: `skill(name="<skill-name>")` to load any skill.

### MCP Servers

| Server | Purpose |
|--------|---------|
| **web-search** (Tavily) | Real-time web search via MCP |
| **pdf-reader** | Read and analyze PDF documents |
| **google-drive** | Access files in Google Drive |
| **memory-plus** | Advanced graph-based memory |
| **codegraph** | Pre-indexed code knowledge graph — 92% fewer tool calls for code exploration |

## Agents

### Primary Agents

| Agent | Description |
|-------|-------------|
| `caveman` | **Default** — Ultra-efficient coder, zero fluff, max output |
| `@spec-architect` | Spec-Driven Development — creates SPEC.md from requirements |
| `@speckit` | Full SpecKit SDD from zero to working build (7 steps via 7-step manual workflow: constitution → specify → clarify → plan → validate → tasks → implement) |
| `@self-healer` | Autonomous debugging — fixes build/test failures silently |
| `@security-auditor` | Security audit — finds vulns, secrets, injection risks |
| `@refactor` | Code refactoring specialist — reduces duplication, modernizes |
| `@docs-writer` | Documentation writer — clear, concise markdown docs |

### Sub-Agents (oh-my-openagent)

| Agent | Category | Purpose |
|-------|----------|---------|
| `sisyphus` | — | Main orchestrator, persistent loops, boulder tracking |
| `hephaestus` | — | Build & forge agent — construction, assembly, heavy lifting |
| `oracle` | ultrabrain | Deep analysis, architecture, research |
| `librarian` | quick | External reference grep — docs, OSS examples |
| `explore` | quick | Codebase exploration and pattern discovery |
| `multimodal-looker` | visual-engineering | Image/visual analysis |
| `prometheus` | deep | Strategic planning, Prometheus plan agent |
| `metis` | deep | Technical design, problem-solving, pre-planning |
| `momus` | writing | Critique, review, plan evaluation |
| `atlas` | unspecified-high | Heavy implementation work |
| `sisyphus-junior` | unspecified-low | Lightweight task execution, category-routed |

### Agent Categories

| Category | Domain | Use Case |
|----------|--------|----------|
| `visual-engineering` | Frontend, UI/UX, design, styling, animation | All visual/UI work |
| `ultrabrain` | Hard logic, architecture, algorithms | Complex reasoning |
| `deep` | Goal-oriented autonomous research + implementation | End-to-end feature work |
| `artistry` | Creative, unconventional problem-solving | Beyond standard patterns |
| `quick` | Trivial tasks, single-file edits, typos | Simple fixes |
| `unspecified-low` | General low-effort work | Non-domain-specific small tasks |
| `unspecified-high` | General high-effort work | Non-domain-specific complex tasks |
| `writing` | Documentation, prose, technical writing | Docs and content |

## Plugins (13)

| Plugin | Role |
|--------|------|
| `oh-my-openagent` | Agent orchestration, Team Mode, sub-agents, MCPs, fallback |
| `opencode-snippets` | `#snippet` inline text expansion |
| `opencode-snip` | Auto `snip` prefix for 60-90% token reduction on shell output |
| `opencode-notify` | Native OS notifications on task completion |
| `opencode-mem` | Persistent vector-DB memory with web UI (localhost:4747) |
| `opencode-quota` | Token usage and cost tracking |
| `opencode-background-agents` | Async delegation (8 concurrent, 5 model-specific) |
| `opencode-worktree` | Zero-friction isolated git worktrees |
| `opencode-dynamic-context-pruning` | Auto-prune obsolete tool outputs after N turns |
| `opencode-smart-title` | Auto-generated meaningful session titles |
| `ocwatch` | Real-time agent activity dashboard |
| `superpowers` | Workflow engine — brainstorming, TDD, subagent-dev, debugging |
| `supermemory` | Cross-session persistent knowledge |

## Skills Ecosystem

- **480+ unique skills** across 3 source trees:
  - `~/.config/opencode/skills/` (~137) — Built-in opencode skills + synced reference presets
  - `~/.agents/skills/` (9) — build-your-own-x, compress, find-skills, skill-sync
  - Project `.claude/skills/` (335) — Marketplace CKMs, community plugins, creative tools, HTML decks
- **Categories**: Frontend, Backend, Languages, Mobile/Desktop, Databases, AI/ML, DevOps, Design, Creative, HTML Decks (50+), Media, Methodology, Workflow
- **MCP Servers**: web-search (Tavily), pdf-reader, google-drive, memory-plus, codegraph

## Team Mode

Team Mode is **enabled** with:
- **8 max parallel members**
- Task system with dependency tracking (`blockedBy`)
- Team messaging and broadcasting
- Shutdown approval workflow
- Supports categories: deep, ultrabrain, quick, visual-engineering, artistry, writing, unspecified-low, unspecified-high

Use `team_create`, `team_send_message`, `team_task_*` tools.

## Usage

```
opencode                          # Launch (caveman mode default)
@spec-architect                   # Create SPEC.md (SDD)
@speckit <idea>                   # Full SpecKit SDD from zero to working build (7 steps)
@self-healer                      # Auto-fix build/test failures
@security-auditor                 # Security audit
@refactor <files>                 # Refactor code
@docs-writer                      # Generate documentation
skill(name="<skill>")             # Load any skill
ulw <task>                        # Ultrawork mode (parallel agents)
#snippet                          # Text expansion
npx openskills read <name>        # Load marketplace skill
```

## OpenCode Tool Mapping

Skills referencing Claude Code tools must use OpenCode equivalents:

| Skill Reference | OpenCode Tool |
|-----------------|---------------|
| `TodoWrite` | `task_create` |
| `TodoWrite` mark complete | `task_update(status="completed")` |
| `TodoWrite` mark in_progress | `task_update(status="in_progress")` |
| List `TodoWrite` | `task_list()` |
| Get `TodoWrite` | `task_get(id)` |

NEVER call `todoWrite` — it will fail. Use the `task_*` tools above.

## Files

| File | Purpose |
|------|---------|
| `~/.config/opencode/opencode.json` | Main config — plugins, agents, model, skills path |
| `~/.config/opencode/oh-my-openagent.json` | Plugin config — sub-agents, team mode, MCP servers, fallback, pruning |
| `~/.config/opencode/AGENTS.md` | Global caveman instructions + skill references |
| `config/opencode.json` | Reference template (project copy) |
| `config/oh-my-openagent.json` | Reference template (project copy) |
| `config/AGENTS.md` | Reference template (project copy) |
| `config/skills/` | 138 reference skill definitions synced to user config |
| `config/skills.txt` | Index of all config skill names |
| `install.ps1` | Windows installer (PowerShell 7+) |
| `install.sh` | Linux/macOS installer |
| `uninstall.ps1` | Windows uninstaller |
| `uninstall.sh` | Linux/macOS uninstaller |
| `.claude/skills/` | 335 project-level skill definitions |
| `scripts/` | CI/CD, validation, and bundle scripts |
| `CONTRIBUTING.md` | Guide for adding skills, plugins, themes |
| `.github/workflows/ci.yml` | CI — validates config, skills, installers |

## Troubleshooting

| Problem | Solution |
|---------|----------|
| `ConfigInvalidError` | Delete `~/.config/opencode/opencode.jsonc` (old format) |
| Plugin not loading | `/plugin remove <name>` then `/plugin add <name>` |
| Skills not triggering | Ensure `~/.config/opencode/skills/<name>/SKILL.md` exists |
| snip not reducing tokens | `snip --version`, reinstall with `go install github.com/edouard-claude/snip/cmd/snip@latest` |
| opencode-mem not working | Check web UI at `http://localhost:4747` |
| Team Mode not working | Verify `team_mode.enabled: true` in oh-my-openagent.json |

## Post-Install

```powershell
opencode auth login   # Authenticate with your AI provider
```

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md). PRs welcome!

## License

MIT

---

<p align="center"><strong>Star the repo</strong> if you found this useful ⭐</p>

opencode-supreme-setup

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README