@hung319/opencode-hive

From Vibe Coding to Hive Coding — The OpenCode plugin for plan-first, structured AI-assisted development with multi-agent orchestration.

Quick Start

Add @hung319/opencode-hive to your opencode.json:

{
  "plugin": ["@hung319/opencode-hive"]
}

That's it. On first load, Hive auto-installs:

• Agent Tools: @sparkleideas/agent-booster (52x faster code editing), @sparkleideas/memory (vector memory)
• CLI Tools: dora (SCIP code navigation), auto-cr-cmd (automated code review), btca-cli
• Snip binary: 60-90% token reduction by filtering shell output

All tools fall back gracefully if installation fails — nothing breaks.

Configuration

Auto-generated at ~/.config/opencode/agent_hive.json:

{
  "agentMode": "unified",
  "agents": {
    "hive": { "model": "anthropic/claude-sonnet-4-20250514", "temperature": 0.5 }
  }
}

| Option | Default | Description | |---|---|---| | agentMode | unified | dedicated splits planner + orchestrator into separate agents | | disableSkills | [] | Globally hide skills from hive_skill() | | disableMcps | [] | Globally disable MCP servers |

Agent Models & Variants

{
  "agents": {
    "hive": { "model": "anthropic/claude-sonnet-4-20250514", "variant": "high" },
    "scout-researcher": { "model": "anthropic/claude-sonnet-4-20250514", "temperature": 0.5 },
    "forager-worker": { "model": "anthropic/claude-sonnet-4-20250514", "variant": "medium" },
    "hygienic-reviewer": { "model": "anthropic/claude-sonnet-4-20250514", "temperature": 0.3 }
  }
}

Variants map to model-specific settings in your opencode.json (e.g., Anthropic thinking budgets).

Custom Derived Subagents

Define derived agents from forager-worker or hygienic-reviewer:

{
  "agents": {
    "forager-worker": {
      "variant": "medium"
    },
    "hygienic-reviewer": {
      "model": "github-copilot/gpt-5.2-codex"
    }
  },
  "customAgents": {
    "forager-ui": {
      "baseAgent": "forager-worker",
      "description": "Use for UI-heavy implementation tasks.",
      "model": "anthropic/claude-sonnet-4-20250514",
      "temperature": 0.2,
      "variant": "high"
    },
    "reviewer-security": {
      "baseAgent": "hygienic-reviewer",
      "description": "Use for security-focused review passes."
    }
  }
}

Omitted fields (model, variant, temperature) inherit from the base agent. autoLoadSkills merges with base defaults, de-duplicates, and applies global disableSkills. Custom agent IDs cannot reuse built-in Hive names or reserved plugin IDs.

Skills

| ID | Use Case | |---|---| | brainstorming | Explore requirements before implementation | | writing-plans | Create detailed implementation plans | | executing-plans | Execute tasks in batches with review checkpoints | | dispatching-parallel-agents | Dispatch 2+ agents for independent work | | test-driven-development | Red-green-refactor cycle | | systematic-debugging | Root cause investigation before fixes | | code-reviewer | Review changes against plan | | verification-before-completion | Verify before claiming done | | docker-mastery | Docker container debugging and optimization |

Per-agent filtering: { "agents": { "forager-worker": { "skills": ["tdd", "verification-before-completion"] } } }

Auto-load skills: Use autoLoadSkills to inject skills into agent prompts at session start:

{
  "agents": {
    "hive": { "autoLoadSkills": ["parallel-exploration"] }
  }
}

Resolution order: Hive builtin → Project OpenCode → Global OpenCode → Project Claude → Global Claude.

MCP Servers

| MCP | Tool | Requires | |---|---|---| | websearch | websearch_web_search_exa | EXA_API_KEY env | | context7 | context7_query-docs | None | | grep_app | grep_app_searchGitHub | None | | pare_search | Structured ripgrep/fd search | None (npx) | | searxng | searxng_search | SEARXNG_URL env |

Tools

| Category | Tools | |---|---| | Feature | hive_feature_create, hive_feature_complete | | Plan | hive_plan_write, hive_plan_read, hive_plan_approve | | Task | hive_tasks_sync, hive_task_create, hive_task_update | | Worktree | hive_worktree_start, hive_worktree_create, hive_worktree_commit, hive_worktree_discard | | Merge | hive_merge | | Context | hive_context_write | | Memory | hive_memory_*, hive_vector_* | | Code | hive_code_edit, hive_lazy_edit, hive_booster_status | | Other | hive_status, hive_skill, hive_agents_md |

Planning-mode delegation

During planning, "don't execute" means "don't implement" (no code edits, no worktrees). Read-only exploration is explicitly allowed and encouraged, both via local tools and by delegating to Scout.

Canonical Delegation Threshold

• Delegate to Scout when you cannot name the file path upfront, expect to inspect 2+ files, or the question is open-ended ("how/where does X work?").
• Local read/grep/glob is acceptable only for a single known file and a bounded question.

Agent Booster (Ultra-Fast Code Editing)

Rust+WASM powered — 52x faster than Morph LLM, no API key needed.

hive_code_edit({
  path: "src/index.ts",
  oldContent: "const old = 'value';",
  newContent: "const new = 'updated';"
})

Vector Memory (Semantic Search)

HNSW indexing for semantic memory search:

hive_vector_add({
  content: "Use async/await instead of .then() chains",
  type: "learning",
  tags: ["javascript", "best-practice"]
})

hive_vector_search({ query: "async patterns", type: "learning", limit: 10 })

Prompt Budgeting

Hive bounds worker prompts to prevent context overflow. Defaults: 10 tasks, 2K chars per summary, 20K per context file, 60K total. Exceeded content is truncated with ...[truncated] markers and file path hints.

Troubleshooting

If a task gets stuck in a blocked-resume loop:

1. Call hive_status() first
2. If pending/in_progress: hive_worktree_start({ feature, task })
3. Only use hive_worktree_create({ task, continueFrom: "blocked", decision }) when status is exactly blocked

License

MIT with Commons Clause — Free for personal and non-commercial use. See LICENSE for details.