XP-Gate OpenCode Plugin

OpenCode plugin exposing xp-gate quality gates and AI workflow skills.

Tools

• gate-check ⇄ xp-gate check <path>: Run user-invokable quality gates (Gate 4 Principles + Gate 6 Architecture) on a file or directory.

• gate-principles ⇄ xp-gate principles <path>: Run Clean Code + SOLID principles checker (Gate 4 standalone).

• gate-arch ⇄ xp-gate arch: Run architecture validation (Gate 6 standalone, layer boundary checks).

• session-reload-model: Reload session model from config. After switching provider configs (opencode.json + oh-my-openagent.json via switch-coding-plan.sh), updates the session model in OpenCode DB to match the new config, so restarted sessions use the current provider/model.

  Usage:

  // Reload current session model from config
  session-reload-model()
  
  // Reload a specific session
  session-reload-model({ sessionId: "ses_xxx" })

• session-rename: Rename an OpenCode session. When called without a newTitle, analyzes the session's recent user messages and auto-generates a descriptive title. Works by directly updating the OpenCode SQLite database (~/.local/share/opencode/opencode.db).

  Usage:

  // Rename current session with auto-generated title
  session-rename()
  
  // Rename a specific session with a custom title
  session-rename({ sessionId: "ses_xxx", newTitle: "Fix auth middleware bug" })

Earlier docs said "all 6 quality gates" — that was inaccurate. gate-check intentionally runs only the two user-invokable gates (Principles + Arch); the full 10-gate pre-commit suite (Gate 0-9) is enforced by xp-gate init's git hooks, not by this tool. Fixes #208.

Installation

In your opencode.json:

{
  "plugin": ["@boyingliu01/opencode-plugin"]
}

Or via local path (development):

{
  "plugin": ["./plugins/opencode"]
}

Requirements

• OpenCode v0.11+
• One of:
  • xp-gate CLI installed globally (npm install -g @boyingliu01/xp-gate) — preferred, or
  • the xp-gate repo checked out locally with src/principles/index.ts reachable — fallback (the tool will shell out via npx -y tsx)
• architecture.yaml in repo root (for gate-arch only)

Graceful Degradation

Every tool runs a chained shell-out: it first tries xp-gate <subcommand> and, only if that's not on PATH, falls back to invoking the underlying checker source directly. If both paths fail, the tool returns install instructions instead of throwing.