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.

Features

• 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

Installation

bunx opencode-arise install

This registers the plugin with OpenCode and creates a default config.

Verify installation:

bunx opencode-arise doctor

Quick Start

After installation, just run OpenCode as usual:

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 Army

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

Direct Summoning

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?

How It Works

┌─────────────────────────────────────────────────────────┐
│                        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

Custom Tools

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 |

Hooks

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

Configuration

Create ~/.config/opencode/opencode-arise.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
  }
}

Configuration Options

| 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.<name>.model | string | varies | Override model for a shadow | | agents.<name>.disabled | 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 |

Project-Level Config

You can also create .opencode/opencode-arise.json in your project root. Project config merges with (and overrides) global config.

Default Models

| Shadow | Default Model | |--------|---------------| | monarch | anthropic/claude-opus-4-5 | | beru | anthropic/claude-haiku-4-5 | | igris | zai-coding-plan/glm-4.7 | | bellion | openai/gpt-5.2 | | tusk | google/gemini-3-pro-preview | | tank | zai-coding-plan/glm-4.7 | | shadow-sovereign | openai/gpt-5.2 (high reasoning) |

Examples

Parallel Codebase Exploration

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

Complex Refactoring

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*

Deep Debugging

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

Uninstall

Remove from OpenCode config:

# Edit ~/.config/opencode/opencode.json
# Remove "opencode-arise" from the "plugin" array

Or manually:

# Remove config
rm ~/.config/opencode/opencode-arise.json

Requirements

• OpenCode CLI installed
• Bun runtime (v1.0.0+)

Philosophy

• 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

Contributing

Contributions are welcome! Please read the contributing guidelines first.

# Clone the repo
git clone https://github.com/moinulmoin/opencode-arise.git
cd opencode-arise

# Install dependencies
bun install

# Run tests
bun test

# Build
bun run build

License

MIT © moinulmoin