opencode-kit

One plugin. Every project gets 18 agents, 40 skills, 16 slash commands, 5 MCPs, and contract-based orchestration, automatically.
Explore the docs »

Report Bug · Request Feature

About The Project

AI coding agents are inconsistent. Without structure, they skip conventions, ignore shared state, bypass quality gates, and use different approaches every run.

opencode-kit is an OpenCode plugin that replaces prose conventions with machine-readable enforcement. Install the plugin once, and every project session gets:

• 18 agents: orchestrator, planner, code-reviewer, council, designer, oracle, and more
• 40 skills: orchestration, firecrawl, gitnexus, TDD, debugging
• 16 slash commands: doctor, status, preflight, ADR, version, and more
• 5 MCPs: lean-ctx, gitnexus, context7, firecrawl, github
• ADR reports: Architecture Decision Records for every decision
• Session summaries: auto-persisted state and lessons learned

All from one plugin reference in opencode.json.

(back to top)

Built With

(back to top)

Getting Started

Prerequisites

• Node.js >= 18
• Git
• OpenCode installed and configured

node --version    # >= 18
git --version     # any recent version

Installation

Step 1: Install globally (one-time)

npm install -g @ikieaneh/opencode-kit

Step 2: Add plugin to your project

Add to your project's opencode.json:

{
  "plugin": ["@ikieaneh/opencode-kit"]
}

That's it. Open your project in OpenCode — the plugin handles everything else.

(back to top)

Usage

On first load, the plugin auto-provisions your project:

opencode.json:   "plugin": ["@ikieaneh/opencode-kit"]
     ↓ (first open)
Plugin writes to opencode.json:
  • 18 agent configs (skills + tools)
  • 16 slash command configs
  • 5 MCP server configs
  • 18 permission configs
Plugin provisions .opencode/:
  • agents/     → 18 agent .md templates
  • skills/     → 39 skill directories
  • rules/      → 4 rule files (from manifest)
  • orchestration/ → contract.json
Plugin registers tui.json:
  • @ikieaneh/opencode-kit/tui (auto-registered)
     ↓
Everything ready — 16 slash commands available

After installation, verify everything loaded:

npx opencode-kit doctor

Expected output:

✅ contract.json
✅ rules.json
✅ 18 agents provisioned
✅ 40 skills provisioned
✅ 7 rule files loaded
✅ All checks passed

(back to top)

Architecture

File Structure

opencode-kit/
├── opencode.json.template    # Framework config (no model/provider)
├── AGENTS.md                 # Agent instructions
├── contract.json             # Contract template
├── contract.schema.json      # Contract schema
├── superpowers-contract.json # Capability manifest (skills, agents, MCPs)
├── agents/                   # 15 agent templates
│   ├── orchestrator.md
│   ├── planner.md
│   ├── code-reviewer.md
│   ├── task-manager.md
│   ├── explorer.md
│   ├── librarian.md
│   ├── architect.md
│   ├── fixer.md
│   ├── learner.md
│   ├── observer.md
│   ├── database-specialist.md
│   ├── devops-agent.md
│   ├── documentation-agent.md
│   ├── security-reviewer.md
│   └── testing-specialist.md
├── skills/                   # 40 skills (40 dirs)
├── rules/                    # 7 rule files
├── src/                      # 22 shell scripts
├── docs/                     # Architecture docs
├── adr/                      # ADR templates
└── package.json

Inheritance Model

opencode-kit uses class inheritance: projects extend the base, not replace it.

// Project's contract.json
{
  "_meta": {
    "extends": "opencode-kit",
    "overrides": ["requirements.goal"],
    "appends": ["scope.included"]
  },
  "requirements": {
    "goal": "Project-specific goal (overrides base)"
  }
}

Merge rules:

• Scalars: project overrides base
• Arrays: concatenated + deduplicated
• Objects: deep merged (project wins)
• Excludes: _meta.excludes removes inherited items

See docs/inheritance-model.md for full architecture.

(back to top)

Agents & Skills

18 Agents

40 Skills

5 MCPs

Plus graphify (CLI tool, not MCP) for codebase graph intelligence.

16 Slash Commands

(back to top)

How It Works

1. Plugin Auto-Provision

When OpenCode starts with @ikieaneh/opencode-kit in the plugin array, the plugin hook fires and provisions files from the package into .opencode/:

• agents/ — 18 agent templates
• skills/ — 40 skills
• rules/ — 7 rule files
• orchestration/contract.json

2. Auto-Config

The plugin writes directly to the project's opencode.json:

• 18 agent configs (skills + tools)
• 16 slash command configs
• 5 MCP server configs
• 18 permission configs

Existing entries are preserved and never overwritten.

3. TUI Registration

The plugin auto-registers @ikieaneh/opencode-kit/tui in tui.json for slash command support in the OpenCode terminal UI.

4. MCP Availability Check

On startup, the plugin reads the capability manifest (superpowers-contract.json) and checks for installed MCPs (lean-ctx, gitnexus, graphify, context7, firecrawl). Missing MCPs produce a warning, not an error.

(back to top)

5. Manifest-Driven Architecture

superpowers-contract.json is the single source of truth for toolkit capabilities. It lists all 40 skills, 18 agents, 5 MCPs, 4 rules, and 22 scripts. Shell scripts and the plugin read from this manifest instead of hardcoding lists. The manifest stays in sync with the package. When you add a skill, it appears in the manifest automatically.

(back to top)

Roadmap

• Auto-provision agents, skills, rules
• Auto-config opencode.json
• ADR reports and session summaries
• Task complexity detection
• Graphify integration
• MCP availability checks
• Inheritance model with overrides and appends
• Scoring pipeline (PASS/RETRY/BLOCKED)
• Multi-language agent support
• Web-based dashboard
• VS Code extension

See ROADMAP.md for full details.

(back to top)

Contributing

See CONTRIBUTING.md for full guidelines.

Fork → Feature branch → Commit → PR. Follow the enforcement architecture. All rule enforcements must be tested.

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

RizkiRachman — GitHub

Project Link: https://github.com/RizkiRachman/opencode-kit

(back to top)

Acknowledgments

• Best-README-Template — README structure
• OpenCode — AI coding agent platform
• lean-ctx — Token-compressed gateway
• graphify — Codebase graph intelligence
• GitNexus — Code intelligence

(back to top)