Solo Leveling themed orchestrator harness for OpenCode - Arise, Shadow Army!
npm install opencode-arise> āļø ARISE! A Solo Leveling themed orchestrator harness for OpenCode


A lightweight, token-efficient orchestrator layer that extends OpenCode with a shadow army of specialized AI agents. Inspired by Solo Leveling's Shadow Monarch, Sung Jinwoo.
- Shadow Army - 7 specialized agents for different tasks
- Smart Delegation - Monarch orchestrates with minimal token usage
- Parallel Execution - Background tasks for concurrent exploration
- Quality-Safe Output - Never truncates errors or stack traces
- Configurable - Customize models, disable shadows, tweak behavior
``bash`
bunx opencode-arise install
This registers the plugin with OpenCode and creates a default config.
Verify installation:
`bash`
bunx opencode-arise doctor
After installation, just run OpenCode as usual:
`bash`
opencode
You'll see the "ARISE!" banner, and the Monarch becomes your default agent. Talk naturally - the Monarch decides when to delegate to shadows.
`
You: "Find all React components using useState and add error boundaries"
Monarch: "I'll have Beru scout the codebase, then Igris implement the changes."
`
| Shadow | Role | Best For |
|--------|------|----------|
| š monarch | Shadow Monarch | Orchestration, delegation decisions |
| š beru | Ant King Scout | Fast codebase exploration, grep, file discovery |
| āļø igris | Loyal Knight | Precise implementation, code changes |
| šļø bellion | Grand Marshal | Strategic planning, architecture analysis |
| šØ tusk | Creative Shadow | UI/UX, frontend, styling |
| š”ļø tank | Research Shadow | External docs, web search, examples |
| šļø shadow-sovereign | Full Power | Deep reasoning, complex debugging |
You can bypass the Monarch and summon shadows directly:
`
@beru find all TODO comments in src/
@bellion plan a migration from REST to GraphQL
@shadow-sovereign why is this recursive function causing a stack overflow?
`
``
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā USER ā
ā ā ā
ā ā¼ ā
ā āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā ā
ā ā š MONARCH ā ā
ā ā (Primary Orchestrator) ā ā
ā ā ā ā
ā ā Assesses task ā Delegates or handles ā ā
ā āāāāāāāāāāāāāāāāāāāāāāāā¬āāāāāāāāāāāāāāāāāāāāāāāāāāā ā
ā ā ā
ā āāāāāāāāā¬āāāāāāāāāāāā¼āāāāāāāāāāāā¬āāāāāāāā ā
ā ā¼ ā¼ ā¼ ā¼ ā¼ ā
ā š āļø šļø š”ļø šļø ā
ā BERU IGRIS BELLION TANK SOVEREIGN ā
ā scout implement plan research reason ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
Monarch's Principles:
1. Assess intent before acting - don't over-delegate
2. Handle trivial tasks directly
3. Use parallel background tasks for exploration
4. Only summon shadow-sovereign for complex problems
5. Verify changes work before declaring done
The plugin provides these tools to the Monarch:
| Tool | Description |
|------|-------------|
| arise_summon | Invoke a shadow (sync or background) |arise_background
| | Launch parallel background task |arise_background_output
| | Get result from background task |arise_background_status
| | List all background tasks |arise_background_cancel
| | Cancel a running task |
| Hook | Description |
|------|-------------|
| arise-banner | Shows "ARISE!" toast on session start |output-shaper
| | Quality-safe output truncation (preserves errors) |compaction-preserver
| | Preserves critical context during session compaction |todo-enforcer
| | Reminds about incomplete TODOs on session idle |
Create ~/.config/opencode/opencode-arise.json:
`json`
{
"show_banner": true,
"disabled_shadows": [],
"disabled_hooks": [],
"agents": {
"monarch": {
"model": "anthropic/claude-sonnet-4"
},
"beru": {
"model": "openai/gpt-4.1-mini"
}
},
"output_shaping": {
"max_chars": 12000,
"preserve_errors": true
},
"compaction": {
"threshold_percent": 80,
"preserve_todos": true
}
}
| Option | Type | Default | Description |
|--------|------|---------|-------------|
| show_banner | boolean | true | Show "ARISE!" toast on session start |banner_every_session
| | boolean | false | Show banner for every session (not just first) |disabled_shadows
| | string[] | [] | Shadows to disable (e.g., ["tusk", "tank"]) |disabled_hooks
| | string[] | [] | Hooks to disable |agents.
| | string | varies | Override model for a shadow |agents.
| | boolean | false | Disable specific shadow |output_shaping.max_chars
| | number | 12000 | Max output length before truncation |output_shaping.preserve_errors
| | boolean | true | Never truncate error outputs |compaction.threshold_percent
| | number | 80 | Context threshold for compaction |compaction.preserve_todos
| | boolean | true | Keep TODOs during compaction |
You can also create .opencode/opencode-arise.json in your project root. Project config merges with (and overrides) global config.
| Shadow | Default Model |
|--------|---------------|
| monarch | anthropic/claude-opus-4-5 |anthropic/claude-haiku-4-5
| beru | |zai-coding-plan/glm-4.7
| igris | |openai/gpt-5.2
| bellion | |google/gemini-3-pro-preview
| tusk | |zai-coding-plan/glm-4.7
| tank | |openai/gpt-5.2
| shadow-sovereign | (high reasoning) |
`
You: "I need to understand how authentication works and find security best practices"
Monarch: launches beru (codebase) and tank (research) in background
"Beru is exploring the auth implementation while Tank researches
security best practices. I'll compile their findings."
`
`
You: "Refactor the payment module to use the new Stripe API"
Monarch: "This requires planning. Let me consult Bellion first."
Bellion: analyzes codebase, creates migration plan
Monarch: "Bellion's plan looks good. Igris will implement it step by step."
Igris: implements changes, runs tests after each step
`
`
You: "This async function is causing race conditions but I can't figure out why"
Monarch: "This needs deep analysis. Summoning the Shadow Sovereign."
Shadow-Sovereign: deep reasoning analysis
"The issue is a closure capturing a stale reference..."
`
Remove from OpenCode config:
`bash`Edit ~/.config/opencode/opencode.json
Remove "opencode-arise" from the "plugin" array
Or manually:
`bash`Remove config
rm ~/.config/opencode/opencode-arise.json
- OpenCode CLI installed
- Bun runtime (v1.0.0+)
- Minimal sufficient delegation - Don't over-delegate simple tasks
- Parallel exploration - Use background tasks for concurrent scouting
- Quality-safe truncation - Never lose errors, tracebacks, or critical output
- Token efficiency - Lean prompts, smart delegation patterns
Contributions are welcome! Please read the contributing guidelines first.
`bashClone the repo
git clone https://github.com/moinulmoin/opencode-arise.git
cd opencode-arise
MIT Ā© moinulmoin
---
"I alone level up." - Sung Jinwoo