Skip to content

PLUGINS.md

Latest commit

 

History

History
195 lines (135 loc) · 5.56 KB

PLUGINS.md

File metadata and controls

195 lines (135 loc) · 5.56 KB

Plugins

This document lists the external MCP servers and plugins used by this OpenCode configuration.

Warp

Repository: warpdotdev/opencode-warp

Official Warp terminal integration for OpenCode.

Features

  • Native Notifications — Get Warp notifications when OpenCode:
    • Completes a task — summary showing your prompt and response
    • Needs your input — when a permission request is pending
    • Runs a tool — status updates as tools execute

Notifications appear in Warp's notification center and as system notifications.

Installation

The plugin is already configured in opencode.json:

{
  "plugin": ["@warp-dot-dev/opencode-warp"]
}

Requirements

How It Works

Uses Warp's pluggable notifications feature via OSC escape sequences. Hooks into:

  • session.created — confirms plugin is active
  • session.idle — fires when OpenCode finishes responding
  • permission.updated / permission.asked — when tool approval is needed
  • message.updated — when user prompt is submitted
  • tool.execute.after — when tool call completes

Uninstall

Remove "@warp-dot-dev/opencode-warp" from the plugin array in opencode.json.

context-mode

Repository: mksglu/context-mode

Context Mode is an MCP server that keeps raw tool output out of your context window and tracks session state in SQLite for continuity across compactions.

  • MCP tools: ctx_batch_execute, ctx_execute, ctx_execute_file, ctx_index, ctx_search, ctx_fetch_and_index
  • Plugin hooks: tool.execute.before, tool.execute.after, experimental.session.compacting

Prerequisites

  • Node.js 18+

Install

Install context-mode globally:

npm install -g context-mode

The opencode.json in this repo already registers context-mode as both an MCP server and a plugin. After installing the npm package and cloning this config, restart OpenCode.

Verify

In an OpenCode session, run:

ctx doctor

All checks should pass. You can also run ctx stats to see context savings.

Upgrade

npm update -g context-mode

Or from within OpenCode:

ctx upgrade

Superpowers

Repository: obra/superpowers

Superpowers is a complete software development workflow for AI coding agents. It provides a composable set of "skills" that trigger automatically based on context.

Core Workflow

  1. brainstorming - Activates before writing code. Refines ideas through questions, presents design in chunks.
  2. writing-plans - Breaks work into bite-sized tasks with exact file paths and verification steps.
  3. subagent-driven-development - Dispatches subagents per task with two-stage review.
  4. test-driven-development - Enforces RED-GREEN-REFACTOR cycle.
  5. requesting-code-review - Reviews against plan, reports issues by severity.

Skills Library

  • brainstorming - Socratic design refinement
  • writing-plans - Detailed implementation plans
  • subagent-driven-development - Fast iteration with review
  • test-driven-development - RED-GREEN-REFACTOR cycle
  • systematic-debugging - 4-phase root cause process
  • And more...

Installation

The plugin is configured in opencode.json:

{
  "plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]
}

Restart OpenCode to load the plugin.

Usage

Use OpenCode's native skill tool:

use skill tool to list skills
use skill tool to load superpowers/brainstorming

Or simply ask: "Tell me about your superpowers"

Get Shit Done (GSD)

Repository: gsd-build/get-shit-done

A meta-prompting, context engineering, and spec-driven development system that solves context rot — the quality degradation that happens as AI fills its context window.

Core Workflow

  1. /gsd:new-project - Full initialization: questions → research → requirements → roadmap
  2. /gsd:discuss-phase [N] - Capture implementation decisions before planning
  3. /gsd:plan-phase [N] - Research + plan + verify for a phase
  4. /gsd:execute-phase [N] - Execute all plans in parallel waves
  5. /gsd:verify-work [N] - Manual user acceptance testing
  6. /gsd:ship [N] - Create PR from verified phase work

Key Commands

Command Description
/gsd-new-project Initialize new project with full workflow
/gsd-quick Fast ad-hoc task execution
/gsd-map-codebase Analyze existing codebase
/gsd-discuss-phase Capture implementation decisions
/gsd-plan-phase Research and plan phase
/gsd-execute-phase Execute plans in waves
/gsd-verify-work User acceptance testing
/gsd-ship Create PR from verified work
/gsd-progress Where am I? What's next?
/gsd-help Show all commands

Installation

GSD commands are included in this repository under command/. They were installed via:

npx get-shit-done-cc@latest --opencode --global

Usage

/gsd-help

The opencode.json in this repo already registers context-mode as both an MCP server and a plugin. After installing the npm package and cloning this config, restart OpenCode.

Verify

In an OpenCode session, run:

ctx doctor

All checks should pass. You can also run ctx stats to see context savings.

Upgrade

npm update -g context-mode

Or from within OpenCode:

ctx upgrade