loadouts 0.2.5 → 0.3.0

package/dist/tui/skins/pi-tui/render.js

@@ -0,0 +1,154 @@
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { intentFromPiTuiInput } from "./input.js";
+import { toPiTuiTheme } from "./theme.js";
+export class PiTuiDashboard {
+    spec;
+    theme;
+    onIntent;
+    constructor(options) {
+        this.spec = options.spec;
+        this.theme = toPiTuiTheme(options.theme);
+        this.onIntent = options.onIntent;
+    }
+    setSpec(spec) {
+        this.spec = spec;
+    }
+    setTheme(theme) {
+        this.theme = toPiTuiTheme(theme);
+    }
+    render(width) {
+        return renderDashboard(this.spec, width, this.theme);
+    }
+    handleInput(data) {
+        const intent = intentFromPiTuiInput(data, this.spec);
+        if (intent)
+            this.onIntent?.(intent);
+    }
+    invalidate() { }
+}
+export class PiTuiOverlay {
+    spec;
+    theme;
+    onIntent;
+    constructor(spec, theme, onIntent) {
+        this.spec = spec;
+        this.theme = toPiTuiTheme(theme);
+        this.onIntent = onIntent;
+    }
+    setSpec(spec) {
+        this.spec = spec;
+    }
+    setTheme(theme) {
+        this.theme = toPiTuiTheme(theme);
+    }
+    render(width) {
+        return renderOverlay(this.spec, width, this.theme);
+    }
+    handleInput(data) {
+        const intent = intentFromPiTuiInput(data);
+        if (intent)
+            this.onIntent?.(intent);
+    }
+    invalidate() { }
+}
+export function renderDashboard(spec, width, theme = toPiTuiTheme()) {
+    const safeWidth = Math.max(1, width);
+    if (safeWidth < 42)
+        return renderNarrow(spec, safeWidth, theme);
+    const gap = 1;
+    const leftWidth = clamp(Math.floor(safeWidth * 0.52), 34, Math.min(64, safeWidth - 24));
+    const rightWidth = Math.max(12, safeWidth - leftWidth - gap);
+    const left = renderLeft(spec, leftWidth, theme);
+    const right = renderDetail(spec, rightWidth, theme);
+    const bodyHeight = Math.max(left.length, right.length);
+    const lines = [];
+    for (let i = 0; i < bodyHeight; i++) {
+        lines.push(fit(`${left[i] ?? blank(leftWidth)} ${right[i] ?? blank(rightWidth)}`, safeWidth));
+    }
+    lines.push(fit(spanLine(spec.footer.equipped, theme), safeWidth));
+    lines.push(fit(spec.footer.keys.map((key) => theme.color.dim(`[${key.key}]`) + theme.color.muted(key.label)).join("  "), safeWidth));
+    return lines.map((line) => fit(line, safeWidth));
+}
+function renderLeft(spec, width, theme) {
+    const lines = [topBorder(" LOADOUTS ", width, theme)];
+    for (const pane of spec.panes) {
+        lines.push(boxLine(theme.color.accent(`> ${pane.title}`), width, theme));
+        if (pane.rows.length === 0) {
+            lines.push(boxLine(theme.color.dim("  -- empty --"), width, theme));
+            continue;
+        }
+        for (const row of pane.rows) {
+            const glyph = theme.color[row.glyph.style](row.glyph.char);
+            const cursor = row.selected ? theme.color.accent(">") : " ";
+            const text = `${cursor} ${glyph} ${spanLine(row.spans, theme)}`;
+            lines.push(boxLine(row.selected ? theme.selected(padTo(text, width - 4)) : text, width, theme));
+        }
+    }
+    lines.push(bottomBorder(width, theme));
+    return lines;
+}
+function renderDetail(spec, width, theme) {
+    const detail = spec.detail;
+    const lines = [topBorder(` ${detail?.title ?? "Detail"} `, width, theme)];
+    if (!detail) {
+        lines.push(boxLine(theme.color.dim("No detail"), width, theme));
+    }
+    else {
+        for (const block of detail.blocks)
+            lines.push(boxLine(spanLine(block, theme), width, theme));
+    }
+    lines.push(bottomBorder(width, theme));
+    return lines;
+}
+function renderNarrow(spec, width, theme) {
+    const lines = [fit(theme.color.accent("LOADOUTS"), width)];
+    for (const pane of spec.panes) {
+        lines.push(fit(theme.color.accent(`> ${pane.title}`), width));
+        for (const row of pane.rows) {
+            const glyph = theme.color[row.glyph.style](row.glyph.char);
+            const cursor = row.selected ? ">" : " ";
+            lines.push(fit(`${cursor} ${glyph} ${spanLine(row.spans, theme)}`, width));
+        }
+    }
+    lines.push(fit(spanLine(spec.footer.equipped, theme), width));
+    return lines;
+}
+export function renderOverlay(overlay, width, theme) {
+    const boxWidth = clamp(width, 24, Math.min(82, width));
+    const lines = [topBorder(` ${overlay.title} `, boxWidth, theme)];
+    for (const line of overlay.lines)
+        lines.push(boxLine(spanLine(line, theme), boxWidth, theme));
+    lines.push(boxLine(theme.color.dim("esc to close"), boxWidth, theme));
+    lines.push(bottomBorder(boxWidth, theme));
+    return lines.map((line) => fit(line, boxWidth));
+}
+function spanLine(spans, theme) {
+    return spans.map((span) => theme.color[span.style ?? "text"](span.text)).join("");
+}
+function topBorder(title, width, theme) {
+    const inner = Math.max(0, width - 2);
+    const clippedTitle = truncateToWidth(title, inner, "", false);
+    const rest = Math.max(0, inner - visibleWidth(clippedTitle));
+    return theme.color.border(`+${clippedTitle}${"-".repeat(rest)}+`);
+}
+function bottomBorder(width, theme) {
+    return theme.color.border(`+${"-".repeat(Math.max(0, width - 2))}+`);
+}
+function boxLine(line, width, theme) {
+    const inner = Math.max(0, width - 4);
+    return fit(`${theme.color.border("| ")}${fit(line, inner)}${theme.color.border(" |")}`, width);
+}
+function fit(line, width) {
+    return truncateToWidth(line, Math.max(0, width), "...", true);
+}
+function padTo(line, width) {
+    const clipped = truncateToWidth(line, Math.max(0, width), "...");
+    return clipped + " ".repeat(Math.max(0, width - visibleWidth(clipped)));
+}
+function blank(width) {
+    return " ".repeat(Math.max(0, width));
+}
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+//# sourceMappingURL=render.js.map

package/dist/tui/skins/pi-tui/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../../src/tui/skins/pi-tui/render.ts"],"names":[],"mappings":"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"}

package/dist/tui/skins/pi-tui/theme.d.ts

@@ -0,0 +1,10 @@
+import { type StyleToken, type ThemeTokens } from "../../core/theme.js";
+export type ColorFn = (text: string) => string;
+export interface PiTuiTheme {
+    color: Record<StyleToken, ColorFn>;
+    selected: ColorFn;
+    background: ColorFn;
+}
+export declare function defaultPiTuiTokens(): ThemeTokens;
+export declare function toPiTuiTheme(tokens?: ThemeTokens): PiTuiTheme;
+//# sourceMappingURL=theme.d.ts.map

package/dist/tui/skins/pi-tui/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../../src/tui/skins/pi-tui/theme.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE5F,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAE/C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACrB;AAeD,wBAAgB,kBAAkB,IAAI,WAAW,CAOhD;AAED,wBAAgB,YAAY,CAAC,MAAM,GAAE,WAAkC,GAAG,UAAU,CAgCnF"}

package/dist/tui/skins/pi-tui/theme.js

@@ -0,0 +1,58 @@
+import chalk from "chalk";
+import { defaultThemeTokens } from "../../core/theme.js";
+const identity = (text) => text;
+const DEFAULT_COLORS = {
+    text: "#d7dae0",
+    muted: "#8f98a8",
+    dim: "#5f6878",
+    accent: "#8bd5ff",
+    success: "#9ece6a",
+    error: "#ff6b7a",
+    warning: "#e0af68",
+    border: "#3b4261",
+};
+export function defaultPiTuiTokens() {
+    return {
+        ...defaultThemeTokens,
+        ...DEFAULT_COLORS,
+        background: "#11131a",
+        selectedBackground: "#27324a",
+    };
+}
+export function toPiTuiTheme(tokens = defaultPiTuiTokens()) {
+    if (process.env.NO_COLOR) {
+        return {
+            color: {
+                text: identity,
+                muted: identity,
+                dim: identity,
+                accent: identity,
+                success: identity,
+                error: identity,
+                warning: identity,
+                border: identity,
+            },
+            selected: identity,
+            background: identity,
+        };
+    }
+    return {
+        color: {
+            text: colorFn(tokens.text, DEFAULT_COLORS.text),
+            muted: colorFn(tokens.muted, DEFAULT_COLORS.muted),
+            dim: colorFn(tokens.dim, DEFAULT_COLORS.dim),
+            accent: colorFn(tokens.accent, DEFAULT_COLORS.accent),
+            success: colorFn(tokens.success, DEFAULT_COLORS.success),
+            error: colorFn(tokens.error, DEFAULT_COLORS.error),
+            warning: colorFn(tokens.warning, DEFAULT_COLORS.warning),
+            border: colorFn(tokens.border, DEFAULT_COLORS.border),
+        },
+        selected: tokens.selectedBackground ? chalk.bgHex(tokens.selectedBackground) : chalk.bgHex("#27324a"),
+        background: tokens.background ? chalk.bgHex(tokens.background) : identity,
+    };
+}
+function colorFn(value, fallback) {
+    const color = value && value.startsWith("#") ? value : fallback;
+    return chalk.hex(color);
+}
+//# sourceMappingURL=theme.js.map

package/dist/tui/skins/pi-tui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../../src/tui/skins/pi-tui/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAqC,MAAM,qBAAqB,CAAC;AAU5F,MAAM,QAAQ,GAAY,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;AAEzC,MAAM,cAAc,GAA+B;IACjD,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,SAAS;IACd,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;CAClB,CAAC;AAEF,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,GAAG,kBAAkB;QACrB,GAAG,cAAc;QACjB,UAAU,EAAE,SAAS;QACrB,kBAAkB,EAAE,SAAS;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAsB,kBAAkB,EAAE;IACrE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,QAAQ;gBACf,GAAG,EAAE,QAAQ;gBACb,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,QAAQ;gBACjB,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,QAAQ;gBACjB,MAAM,EAAE,QAAQ;aACjB;YACD,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,QAAQ;SACrB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE;YACL,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC;YAC/C,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;YAClD,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,GAAG,CAAC;YAC5C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC;YACrD,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC;YACxD,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;YAClD,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC;YACxD,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC;SACtD;QACD,QAAQ,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC;QACrG,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ;KAC1E,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,KAAyB,EAAE,QAAgB;IAC1D,MAAM,KAAK,GAAG,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChE,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC"}

package/docs/authoring.md

@@ -219,7 +219,7 @@ include:
 
 ---
 
-## OpenCode Config And Plugins
+## OpenCode Config, Commands, And Plugins
 
 OpenCode-specific artifacts live under `.loadouts/opencode/` and only render when included in a loadout that targets `opencode`.
 
@@ -234,6 +234,16 @@ OpenCode-specific artifacts live under `.loadouts/opencode/` and only render whe
 
 Project scope renders this to `opencode.jsonc`. Global scope renders it to `~/.config/opencode/opencode.jsonc`. This is whole-file ownership; if you do not include this artifact, loadouts does not touch your OpenCode config file.
 
+**Slash commands:**
+```md
+<!-- .loadouts/opencode/commands/loadouts.md -->
+# /loadouts
+
+Arguments: `$ARGUMENTS`
+```
+
+Project scope renders this to `.opencode/commands/loadouts.md`. Global scope renders it to `~/.config/opencode/commands/loadouts.md`.
+
 **Local plugins:**
 ```ts
 // .loadouts/opencode/plugins/notify.ts
@@ -252,11 +262,53 @@ Project scope renders this to `.opencode/plugins/notify.ts`. Global scope render
 ```yaml
 include:
   - opencode/opencode.jsonc
+  - opencode/commands/loadouts.md
   - opencode/plugins/notify.ts
 ```
 
 NPM plugins belong in the managed `opencode.json(c)` `plugin` array. Local plugin source files belong in `.loadouts/opencode/plugins/`.
 
+**TUI plugins:**
+
+OpenCode TUI plugins are local plugin modules loaded from `tui.json(c)`. They are useful for user-facing UI that should not be added to chat or model-visible prompt context.
+
+```tsx
+// .loadouts/opencode/plugins/status-popup.tsx
+/** @jsxImportSource @opentui/solid */
+
+import type { TuiPlugin, TuiPluginModule } from "@opencode-ai/plugin/tui";
+
+const tui: TuiPlugin = async (api) => {
+  api.keymap.registerLayer({
+    commands: [
+      {
+        name: "status_popup_open",
+        title: "Open status popup",
+        category: "Plugin",
+        namespace: "palette",
+        slashName: "status-popup",
+        run() {
+          api.ui.dialog.setSize("medium");
+          api.ui.dialog.replace(() => <box border paddingLeft={2}>TUI-only popup</box>);
+        },
+      },
+    ],
+  });
+};
+
+export default { id: "status-popup", tui } satisfies TuiPluginModule & { id: string };
+```
+
+```jsonc
+// .loadouts/opencode/tui.jsonc
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": ["./plugins/status-popup.tsx"]
+}
+```
+
+Project scope renders this config to `.opencode/tui.jsonc`. Global scope renders it to `~/.config/opencode/tui.jsonc`. This is whole-file ownership; if you already manage `tui.jsonc`, add the plugin entry there instead of including this artifact.
+
 ---
 
 ## Custom Kinds

package/docs/commands.md

@@ -52,12 +52,16 @@ Compile a runtime bundle for inspection (no filesystem activation). Defaults to
 loadouts runtime                     # Compile default loadout
 loadouts runtime base backend        # Compile multiple loadouts
 loadouts runtime base --tool cursor  # Target a different tool
+loadouts runtime base -l             # Force local/project scope
+loadouts runtime base -g             # Force global scope
 loadouts runtime base --json         # Output RuntimeBundle JSON only
 loadouts runtime base --system-block # Output renderRuntimeSystemBlock(bundle) only
 ```
 
 See `docs/runtime.md` for architecture, OpenCode-first integration flow, and per-tool capability flags.
 
+For OpenCode runtime plugin integrations, this is exposed as `/loadouts activate|a|use ...`, `/loadouts list|ls`, `/loadouts info`, and `/loadouts clear`. The bundled fallback command omits `$ARGUMENTS` to reduce model-visible command noise, and runtime JSON/intermediate plugin output should stay hidden. User-visible slash command acknowledgment text may still be model-mediated by OpenCode even when plugin state handling is deterministic.
+
 ### `loadouts diff [name]`
 Preview what would change if a loadout were applied.
 ```bash

package/docs/compatibility.md

@@ -4,13 +4,13 @@ Current built-in rendering targets for canonical artifacts.
 
 ## Artifact Paths (Project Scope)
 
-| Tool | Rule | Skill | Agent | Instruction |
-|------|------|-------|-------|-------------|
-| Claude Code | `.claude/rules/<name>.md` | `.claude/skills/<name>/` | `.claude/agents/<name>.md` | `CLAUDE.md` (generated wrapper to `AGENTS.md`) |
-| Cursor | `.cursor/rules/<name>.mdc` | `.cursor/skills/<name>/` | `.cursor/agents/<name>.md` | `AGENTS.md` |
-| OpenCode | `.opencode/rules/<name>.md` | `.opencode/skills/<name>/` | `.opencode/agents/<name>.md` | `AGENTS.md` |
-| Codex | - (no rule target) | `.agents/skills/<name>/` | `.codex/agents/<name>.toml` | `AGENTS.md` |
-| Pi | - (no native rule target) | `.pi/skills/<name>/` | - | `AGENTS.md` |
+| Tool | Rule | Skill | Agent | Instruction | Extra Artifacts |
+|------|------|-------|-------|-------------|-----------------|
+| Claude Code | `.claude/rules/<name>.md` | `.claude/skills/<name>/` | `.claude/agents/<name>.md` | `CLAUDE.md` (generated wrapper to `AGENTS.md`) | - |
+| Cursor | `.cursor/rules/<name>.mdc` | `.cursor/skills/<name>/` | `.cursor/agents/<name>.md` | `AGENTS.md` | - |
+| OpenCode | `.opencode/rules/<name>.md` | `.opencode/skills/<name>/` | `.opencode/agents/<name>.md` | `AGENTS.md` | `.opencode/commands/<name>.md`, `.opencode/plugins/<name>.{ts,tsx,js}`, `.opencode/tui.json(c)`, `opencode.json(c)` |
+| Codex | - (no rule target) | `.agents/skills/<name>/` | `.codex/agents/<name>.toml` | `AGENTS.md` | - |
+| Pi | - (no native rule target) | `.pi/skills/<name>/` | - | `AGENTS.md` | - |
 
 Global scope uses each tool's configured global base path. Instruction files may render to home-level `AGENTS.md` or `CLAUDE.md` paths depending on the tool.
 

package/docs/concepts.md

@@ -79,7 +79,9 @@ include:
 | `prompt` | file | Slash command templates |
 | `extension` | directory | Runtime code extensions |
 | `theme` | file | UI theme configuration |
+| `opencode-command` | file | OpenCode slash command markdown |
 | `opencode-config` | file | Whole-file OpenCode runtime configuration |
+| `opencode-tui-config` | file | Whole-file OpenCode TUI configuration |
 | `opencode-plugin` | file | Local OpenCode plugin modules |
 
 ## Supported Tools
@@ -88,9 +90,9 @@ include:
 |------|-------|--------|--------|--------------|-----------------|
 | Claude Code | `.claude/rules/*.md` | `.claude/skills/` | `.claude/agents/*.md` | `CLAUDE.md` | — |
 | Cursor | `.cursor/rules/*.mdc` | `.cursor/skills/` | `.cursor/agents/*.md` | `AGENTS.md` | — |
-| OpenCode | `.opencode/rules/*.md` | `.opencode/skills/` | `.opencode/agents/*.md` | `AGENTS.md` | `opencode.json(c)`, `.opencode/plugins/` |
+| OpenCode | `.opencode/rules/*.md` | `.opencode/skills/` | `.opencode/agents/*.md` | `AGENTS.md` | `opencode.json(c)`, `.opencode/tui.json(c)`, `.opencode/plugins/`, `.opencode/commands/*.md` |
 | Codex | — | `.agents/skills/` | `.codex/agents/*.toml` | `AGENTS.md` | — |
-| Pi | `.pi/rules/*.md` | `.pi/skills/` | — | `AGENTS.md` | `.pi/extensions/`, `.pi/themes/` |
+| Pi | — | `.pi/skills/` | — | `AGENTS.md` | `.pi/prompts/*.md`, `.pi/extensions/`, `.pi/themes/` |
 
 ## Sources (Cross-Project Config)
 

package/docs/runtime.md

@@ -43,6 +43,37 @@ Recommended integration pattern:
 - Inject `instructions` and `rules` into model/system context.
 - Register `skills[*].path` for discovery only.
 
+### Slash Command UX (`/loadouts`)
+
+The OpenCode runtime path is designed around a deterministic plugin-backed slash command:
+
+```text
+/loadouts activate base
+/loadouts a base -l
+/loadouts a release -g
+/loadouts list
+/loadouts info base
+/loadouts clear
+```
+
+Expected behavior:
+
+- The server plugin maps `/loadouts activate|a|use <names...>` to `loadouts runtime ...` (or equivalent runtime adapter path) and computes session runtime state deterministically.
+- The TUI plugin listens for server plugin events and renders status/results in a TUI-only dialog that is not appended to chat and is not visible to the assistant.
+- `-l/--local` and `-g/--global` are supported as direct scope selectors for runtime compilation.
+- Runtime JSON and intermediate plugin outputs stay hidden from the model-facing response.
+- The server and TUI plugins share persisted runtime state through `~/.cache/loadouts/opencode-runtime/<cwd-hash>.json`; the server plugin uses that state during system-message injection.
+- A bundled scaffold loadout (`opencode-runtime`) renders `.opencode/plugins/loadouts-runtime.ts`, `.opencode/plugins/loadouts-runtime-tui.tsx`, and `.opencode/tui.jsonc`.
+
+### Known OpenCode Runtime Semantics
+
+- The runtime plugin's `command.execute.before` hook is deterministic for parsing `/loadouts` arguments and updating runtime state.
+- In interactive OpenCode, the server plugin owns `/loadouts` command handling and the TUI plugin owns user-visible feedback. If the TUI plugin is not loaded, the server plugin remains the headless/fallback path.
+- OpenCode may still route server slash command text through model-facing flows when the TUI plugin is absent. Treat user-visible server acknowledgment text as host-dependent.
+- OpenCode loads server plugins and TUI plugins at startup. Restart OpenCode after changing or activating runtime plugin or TUI config artifacts.
+- The plugin bridge shells out to `loadouts runtime ...`. Ensure the `loadouts` binary available on OpenCode's `PATH` includes runtime support.
+- The bundled TUI config is whole-file managed like other Loadouts config artifacts. Existing unmanaged `.opencode/tui.jsonc` files are protected by normal shadowing; add `./plugins/loadouts-runtime-tui.tsx` to your existing TUI config if needed.
+
 ## Tool Capability Matrix (Runtime v1)
 
 The bundle always includes resolved instructions, rules, and skill references. Capability flags tell consumers what should be treated as native runtime behavior for each tool.
@@ -67,6 +98,10 @@ For filesystem-first tools, use standard `activate/sync` as the primary path and
 
 ## Reference Scaffold
 
-- Example OpenCode plugin scaffold: `docs/examples/opencode-runtime-plugin.ts`
+- Bundled OpenCode server runtime plugin: `bundled/opencode/plugins/loadouts-runtime.ts`
+- Bundled OpenCode TUI runtime plugin: `bundled/opencode/plugins/loadouts-runtime-tui.tsx`
+- Bundled OpenCode TUI config: `bundled/opencode/tui.jsonc`
+- Bundled scaffold loadout: `bundled/loadouts/opencode-runtime.yaml`
+- Historical/reference plugin scaffold: `docs/examples/opencode-runtime-plugin.ts`
 - Core compiler implementation: `src/core/runtime.ts`
 - CLI command surface: `src/cli/commands/runtime.ts`

package/docs/troubleshooting.md

@@ -51,7 +51,24 @@ loadouts sync      # Re-render if needed
 
 **Cursor:** Rules need `.mdc` extension — loadouts handles this automatically. Restart Cursor if rules don't appear immediately.
 
-**OpenCode:** Rules render to `.opencode/rules/`. Local plugins render to `.opencode/plugins/`, and NPM plugins are configured with the `plugin` array in `opencode.json(c)`.
+**OpenCode:** Rules render to `.opencode/rules/`, commands to `.opencode/commands/`, local plugins to `.opencode/plugins/`, and NPM plugins are configured with the `plugin` array in `opencode.json(c)`.
+
+### `/loadouts` not working in OpenCode runtime
+
+If `/loadouts` exists but does not activate runtime behavior, verify the full chain:
+
+1. Runtime artifacts are rendered in the expected scope:
+   - Local server plugin: `.opencode/plugins/loadouts-runtime.ts`
+   - Local TUI plugin/config: `.opencode/plugins/loadouts-runtime-tui.tsx` and `.opencode/tui.jsonc`
+   - Global server plugin: `~/.config/opencode/plugins/loadouts-runtime.ts`
+   - Global TUI plugin/config: `~/.config/opencode/plugins/loadouts-runtime-tui.tsx` and `~/.config/opencode/tui.jsonc`
+2. Runtime scaffold is active in the same scope (`loadouts info -l` or `loadouts info -g`).
+3. Restart OpenCode after activation or plugin/TUI config changes (startup-time plugin loading).
+4. Check the `loadouts` binary on OpenCode's `PATH` supports runtime:
+```bash
+loadouts runtime base --tool opencode --json
+```
+5. In interactive OpenCode, the server plugin owns `/loadouts` and the TUI plugin listens for server events to render a user-only dialog. If command acknowledgment text looks model-generated, the TUI plugin is probably not loaded; the deterministic fallback is still server plugin state update and runtime system injection.
 
 **Claude Code:** Verify rules exist in `.claude/rules/`. May require restarting the session.