opencode-kit

One plugin. Every project gets 15 agents, 39 skills, 15 slash commands, 5 MCPs, and contract-based orchestration — automatically.
Explore the docs »

Report Bug · Request Feature

About The Project

AI coding agents are powerful but 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:

• 15 agents — orchestrator, planner, code-reviewer, and more
• 39 skills — orchestration, firecrawl, gitnexus, TDD, debugging
• 15 slash commands — doctor, status, preflight, ADR, 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 a single plugin reference in opencode.json. Zero manual setup.

(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:
  • 15 agent configs (skills + tools)
  • 15 slash command configs
  • 5 MCP server configs
  • 18 permission configs
Plugin provisions .opencode/:
  • agents/     → 15 agent .md templates
  • skills/     → 39 skill directories
  • rules/      → 7 rule files
  • orchestration/ → contract.json
Plugin registers tui.json:
  • @ikieaneh/opencode-kit/tui (auto-registered)
     ↓
Everything ready — 15 slash commands available

After installation, verify everything loaded:

npx opencode-kit doctor

Expected output:

✅ contract.json
✅ rules.json
✅ 15 agents provisioned
✅ 39 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
├── 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/                   # 39 skills (65 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

15 Agents

39 Skills

5 MCPs

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

15 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/ — 15 agent templates
• skills/ — 39 skills
• rules/ — 7 rule files
• orchestration/contract.json

2. Auto-Config

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

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

Existing entries are preserved — 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 checks for required MCPs (lean-ctx, gitnexus, graphify) and warns if any are missing.

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