oh-my-opencode-slim 0.5.3 → 0.5.4

package/README.md

@@ -52,6 +52,7 @@
 - [🔌 **MCP Servers**](#mcp-servers)
 - [⚙️ **Configuration**](#configuration)
   - [Files You Edit](#files-you-edit)
+  - [Prompt Overriding](#prompt-overriding)
   - [Plugin Config](#plugin-config-oh-my-opencode-slimjson)
     - [Presets](#presets)
     - [Option Reference](#option-reference)
@@ -281,38 +282,41 @@ Code implementation, refactoring, testing, verification. *Execute the plan - no
 
 ### Tmux Integration
 
-> ⚠️ **Known Issue:** When the server port is enabled, only one OpenCode instance can be opened at a time. We're tracking this in [issue #15](https://github.com/alvinunreal/oh-my-opencode-slim/issues/15), and there's an upstream PR to OpenCode: [opencode#9099](https://github.com/anomalyco/opencode/issues/9099).
+> ⚠️ **Temporary workaround:** Start OpenCode with `--port` to enable tmux integration. The port must match the `OPENCODE_PORT` environment variable (default: 4096). This is required until the upstream issue is resolved. [opencode#9099](https://github.com/anomalyco/opencode/issues/9099).
 
 <img src="img/tmux.png" alt="Tmux Integration" width="800">
 
 **Watch your agents work in real-time.** When the Orchestrator launches sub-agents or initiates background tasks, new tmux panes automatically spawn showing each agent's live progress. No more waiting in the dark.
 
-#### Why This Matters
+#### Quick Setup
 
-| Without Tmux Integration | With Tmux Integration |
-|--------------------------|----------------------|
-| Fire off a background task, wait anxiously | See the agent thinking, searching, coding |
-| "Is it stuck or just slow?" | Watch tool calls happen in real-time |
-| Results appear out of nowhere | Follow the journey from question to answer |
-| Debug by guessing | Debug by observation |
+1. **Enable tmux integration** in `oh-my-opencode-slim.json` (see [Plugin Config](#plugin-config-oh-my-opencode-slimjson)).
 
-#### What You Get
+  ```json
+  {
+    "tmux": {
+      "enabled": true,
+      "layout": "main-vertical",
+      "main_pane_size": 60
+    }
+  }
+  ```
 
-- **Live Visibility**: Each sub-agent gets its own pane showing real-time output
-- **Auto-Layout**: Tmux automatically arranges panes using your preferred layout
-- **Auto-Cleanup**: Panes close when agents finish, layout rebalances
-- **Zero Overhead**: Works with OpenCode's built-in `task` tool AND our `background_task` tool
+2. **Run OpenCode inside tmux**:
+    ```bash
+    tmux
+    opencode --port 4096
+    ```
 
-#### Quick Setup
+   Or use a custom port (must match `OPENCODE_PORT` env var):
+    ```bash
+    tmux
+    export OPENCODE_PORT=5000
+    opencode --port 5000
+    ```
 
-> ⚠️ **Temporary workaround:** Start OpenCode with `--port 4096` to enable tmux integration. This is required until the upstream issue is resolved.
+   This allows multiple OpenCode instances on different ports.
 
-1. **Enable tmux integration** in `oh-my-opencode-slim.json` (see [Plugin Config](#plugin-config-oh-my-opencode-slimjson)).
-2. **Run OpenCode inside tmux with port 4096**:
-   ```bash
-   tmux
-   opencode --port 4096
-   ```
 
 #### Layout Options
 
@@ -324,8 +328,6 @@ Code implementation, refactoring, testing, verification. *Execute the plan - no
 | `even-horizontal` | All panes side by side |
 | `even-vertical` | All panes stacked vertically |
 
-*See the [Option Reference](#option-reference) for detailed configuration.*
-
 ---
 
 ### Quota Tool
@@ -363,6 +365,8 @@ Language Server Protocol integration for code intelligence:
 | `lsp_diagnostics` | Get errors/warnings from the language server |
 | `lsp_rename` | Rename a symbol across all files |
 
+> **Built-in LSP Servers:** OpenCode includes pre-configured LSP servers for 30+ languages (TypeScript, Python, Rust, Go, etc.). See the [official documentation](https://opencode.ai/docs/lsp/#built-in) for the full list and requirements.
+
 ---
 
 ### Code Search Tools
@@ -377,6 +381,14 @@ Fast code search and refactoring:
 
 ---
 
+### Formatters
+
+OpenCode automatically formats files after they're written or edited using language-specific formatters.
+
+> **Built-in Formatters:** Includes support for Prettier, Biome, gofmt, rustfmt, ruff, and 20+ others. See the [official documentation](https://opencode.ai/docs/formatters/#built-in) for the complete list.
+
+---
+
 ## 🧩 Skills
 
 Skills are specialized capabilities that agents can use. Each agent has a default set of skills, which you can override in the agent config.
@@ -460,6 +472,37 @@ You can disable specific MCP servers by adding them to the `disabled_mcps` array
 
 ---
 
+### Prompt Overriding
+
+You can customize agent prompts by creating markdown files in `~/.config/opencode/oh-my-opencode-slim/`:
+
+| File | Purpose |
+|------|---------|
+| `{agent}.md` | Replaces the default prompt entirely |
+| `{agent}_append.md` | Appends to the default prompt |
+
+**Example:**
+
+```
+~/.config/opencode/oh-my-opencode-slim/
+  ├── orchestrator.md          # Custom orchestrator prompt
+  ├── orchestrator_append.md   # Append to default orchestrator prompt
+  ├── explorer.md
+  ├── explorer_append.md
+  └── ...
+```
+
+**Usage:**
+
+- Create `{agent}.md` to completely replace an agent's default prompt
+- Create `{agent}_append.md` to add custom instructions to the default prompt
+- Both files can exist simultaneously - the replacement takes precedence
+- If neither file exists, the default prompt is used
+
+This allows you to fine-tune agent behavior without modifying the source code.
+
+---
+
 ### Plugin Config (`oh-my-opencode-slim.json`)
 
 The installer generates this file based on your providers. You can manually customize it to mix and match models.
@@ -526,6 +569,23 @@ The installer generates presets for different provider combinations. Switch betw
 | `zen-free` | Free models (GLM-4.7 + Grok Code) |
 | `antigravity-openai` | Mixed: Antigravity for most agents, OpenAI for Oracle |
 
+#### Author's Preset
+
+The author's personal configuration using Cerebras for the Orchestrator:
+
+```json
+{
+  "cerebras": {
+    "orchestrator": { "model": "cerebras/zai-glm-4.7", "skills": ["*"] },
+    "oracle": { "model": "openai/gpt-5.2-codex", "variant": "high", "skills": [] },
+    "librarian": { "model": "google/gemini-3-flash", "variant": "low", "skills": [] },
+    "explorer": { "model": "google/gemini-3-flash", "variant": "low", "skills": [] },
+    "designer": { "model": "google/gemini-3-flash", "variant": "medium", "skills": ["playwright"] },
+    "fixer": { "model": "google/gemini-3-flash", "variant": "low", "skills": [] }
+  }
+}
+```
+
 **Environment Variable Override:**
 
 You can override the preset using an environment variable:

package/dist/agents/coder.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from './orchestrator';
+export declare function createCoderAgent(model: string): AgentDefinition;

package/dist/agents/designer.d.ts

@@ -1,2 +1,2 @@
-import type { AgentDefinition } from "./orchestrator";
-export declare function createDesignerAgent(model: string): AgentDefinition;
+import type { AgentDefinition } from './orchestrator';
+export declare function createDesignerAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/document-writer.d.ts

@@ -0,0 +1,4 @@
+import type { AgentDefinition } from './orchestrator';
+export declare function createDocumentWriterAgent(
+  model: string,
+): AgentDefinition;

package/dist/agents/explore.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from './orchestrator';
+export declare function createExploreAgent(model: string): AgentDefinition;

package/dist/agents/explorer.d.ts

@@ -1,2 +1,2 @@
-import type { AgentDefinition } from "./orchestrator";
-export declare function createExplorerAgent(model: string): AgentDefinition;
+import type { AgentDefinition } from './orchestrator';
+export declare function createExplorerAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/fixer.d.ts

@@ -1,2 +1,2 @@
-import type { AgentDefinition } from "./orchestrator";
-export declare function createFixerAgent(model: string): AgentDefinition;
+import type { AgentDefinition } from './orchestrator';
+export declare function createFixerAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/frontend.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from './orchestrator';
+export declare function createFrontendAgent(model: string): AgentDefinition;

package/dist/agents/index.d.ts

@@ -1,8 +1,8 @@
-import type { AgentConfig as SDKAgentConfig } from "@opencode-ai/sdk";
-import { SUBAGENT_NAMES, type PluginConfig } from "../config";
-import { type AgentDefinition } from "./orchestrator";
-export type { AgentDefinition } from "./orchestrator";
-export type SubagentName = typeof SUBAGENT_NAMES[number];
+import type { AgentConfig as SDKAgentConfig } from '@opencode-ai/sdk';
+import { type PluginConfig, SUBAGENT_NAMES } from '../config';
+import { type AgentDefinition } from './orchestrator';
+export type { AgentDefinition } from './orchestrator';
+export type SubagentName = (typeof SUBAGENT_NAMES)[number];
 export declare function isSubagent(name: string): name is SubagentName;
 /**
  * Create all agent definitions with optional configuration overrides.

package/dist/agents/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/agents/librarian.d.ts

@@ -1,2 +1,2 @@
-import type { AgentDefinition } from "./orchestrator";
-export declare function createLibrarianAgent(model: string): AgentDefinition;
+import type { AgentDefinition } from './orchestrator';
+export declare function createLibrarianAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/multimodal.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from './orchestrator';
+export declare function createMultimodalAgent(model: string): AgentDefinition;

package/dist/agents/oracle.d.ts

@@ -1,2 +1,2 @@
-import type { AgentDefinition } from "./orchestrator";
-export declare function createOracleAgent(model: string): AgentDefinition;
+import type { AgentDefinition } from './orchestrator';
+export declare function createOracleAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/orchestrator.d.ts

@@ -1,7 +1,7 @@
-import type { AgentConfig } from "@opencode-ai/sdk";
+import type { AgentConfig } from '@opencode-ai/sdk';
 export interface AgentDefinition {
     name: string;
     description?: string;
     config: AgentConfig;
 }
-export declare function createOrchestratorAgent(model: string): AgentDefinition;
+export declare function createOrchestratorAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/planner.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from './orchestrator';
+export declare function createPlannerAgent(model: string): AgentDefinition;

package/dist/agents/scribe.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from './orchestrator';
+export declare function createScribeAgent(model: string): AgentDefinition;

package/dist/agents/simplicity-reviewer.d.ts

@@ -0,0 +1,4 @@
+import type { AgentDefinition } from './orchestrator';
+export declare function createSimplicityReviewerAgent(
+  model: string,
+): AgentDefinition;

package/dist/agents/specialist.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from './orchestrator';
+export declare function createSpecialistAgent(model: string): AgentDefinition;

package/dist/background/background-manager.d.ts

@@ -11,9 +11,9 @@
  * - Integrates with tmux for visual feedback (when enabled)
  * - Supports task cancellation and result retrieval
  */
-import type { PluginInput } from "@opencode-ai/plugin";
-import type { TmuxConfig } from "../config/schema";
-import type { PluginConfig } from "../config";
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { PluginConfig } from '../config';
+import type { TmuxConfig } from '../config/schema';
 /**
  * Represents a background task running in an isolated session.
  * Tasks are tracked from creation through completion or failure.
@@ -23,7 +23,7 @@ export interface BackgroundTask {
     sessionId: string;
     description: string;
     agent: string;
-    status: "pending" | "running" | "completed" | "failed";
+    status: 'pending' | 'running' | 'completed' | 'failed';
     result?: string;
     error?: string;
     startedAt: Date;

package/dist/background/index.d.ts

@@ -1,2 +1,2 @@
-export { BackgroundTaskManager, type BackgroundTask, type LaunchOptions } from "./background-manager";
-export { TmuxSessionManager } from "./tmux-session-manager";
+export { type BackgroundTask, BackgroundTaskManager, type LaunchOptions, } from './background-manager';
+export { TmuxSessionManager } from './tmux-session-manager';

package/dist/background/tmux-session-manager.d.ts

@@ -1,5 +1,5 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-import type { TmuxConfig } from "../config/schema";
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { TmuxConfig } from '../config/schema';
 /**
  * TmuxSessionManager tracks child sessions (created by OpenCode's Task tool)
  * and spawns/closes tmux panes for them.

package/dist/cli/config-io.d.ts

@@ -1,4 +1,4 @@
-import type { ConfigMergeResult, DetectedConfig, InstallConfig, OpenCodeConfig } from "./types";
+import type { ConfigMergeResult, DetectedConfig, InstallConfig, OpenCodeConfig } from './types';
 /**
  * Strip JSON comments (single-line // and multi-line) and trailing commas for JSONC support.
  */

package/dist/cli/config-manager.d.ts

@@ -1,4 +1,4 @@
-export * from "./paths";
-export * from "./providers";
-export * from "./system";
-export * from "./config-io";
+export * from './config-io';
+export * from './paths';
+export * from './providers';
+export * from './system';

package/dist/cli/config-manager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/index.js

@@ -4,6 +4,16 @@
 // src/cli/install.ts
 import * as readline from "readline/promises";
 
+// src/cli/config-io.ts
+import {
+  copyFileSync,
+  existsSync as existsSync2,
+  readFileSync,
+  renameSync,
+  statSync,
+  writeFileSync
+} from "fs";
+
 // src/cli/paths.ts
 import { existsSync, mkdirSync } from "fs";
 import { homedir } from "os";
@@ -36,6 +46,7 @@ function ensureConfigDir() {
     mkdirSync(configDir, { recursive: true });
   }
 }
+
 // src/tools/skill/builtin.ts
 var DEFAULT_AGENT_SKILLS = {
   orchestrator: ["*"],
@@ -255,7 +266,9 @@ function generateLiteConfig(installConfig) {
     ]));
     config.presets[providerName] = agents2;
   }
-  const mixedAgents = { ...MODEL_MAPPINGS.antigravity };
+  const mixedAgents = {
+    ...MODEL_MAPPINGS.antigravity
+  };
   mixedAgents.oracle = { model: "openai/gpt-5.2-codex", variant: "high" };
   const agents = Object.fromEntries(Object.entries(mixedAgents).map(([k, v]) => [
     k,
@@ -278,6 +291,7 @@ function generateLiteConfig(installConfig) {
   }
   return config;
 }
+
 // src/cli/system.ts
 async function isOpenCodeInstalled() {
   try {
@@ -315,8 +329,8 @@ async function fetchLatestVersion(packageName) {
     return null;
   }
 }
+
 // src/cli/config-io.ts
-import { existsSync as existsSync2, readFileSync, writeFileSync, statSync, renameSync, copyFileSync } from "fs";
 var PACKAGE_NAME = "oh-my-opencode-slim";
 function stripJsonComments(json) {
   const commentPattern = /\\"|"(?:\\"|[^"])*"|(\/\/.*|\/\*[\s\S]*?\*\/)/g;
@@ -339,7 +353,7 @@ function parseConfigFile(path) {
   }
 }
 function parseConfig(path) {
-  let result = parseConfigFile(path);
+  const result = parseConfigFile(path);
   if (result.config || result.error)
     return result;
   if (path.endsWith(".json")) {
@@ -354,7 +368,7 @@ function writeConfig(configPath, config) {
   }
   const tmpPath = `${configPath}.tmp`;
   const bakPath = `${configPath}.bak`;
-  const content = JSON.stringify(config, null, 2) + `
+  const content = `${JSON.stringify(config, null, 2)}
 `;
   if (existsSync2(configPath)) {
     copyFileSync(configPath, bakPath);
@@ -376,7 +390,11 @@ async function addPluginToOpenCodeConfig() {
   try {
     const { config: parsedConfig, error } = parseConfig(configPath);
     if (error) {
-      return { success: false, configPath, error: `Failed to parse config: ${error}` };
+      return {
+        success: false,
+        configPath,
+        error: `Failed to parse config: ${error}`
+      };
     }
     const config = parsedConfig ?? {};
     const plugins = config.plugin ?? [];
@@ -399,7 +417,11 @@ async function addAuthPlugins(installConfig) {
     ensureConfigDir();
     const { config: parsedConfig, error } = parseConfig(configPath);
     if (error) {
-      return { success: false, configPath, error: `Failed to parse config: ${error}` };
+      return {
+        success: false,
+        configPath,
+        error: `Failed to parse config: ${error}`
+      };
     }
     const config = parsedConfig ?? {};
     const plugins = config.plugin ?? [];
@@ -427,7 +449,11 @@ function addProviderConfig(installConfig) {
     ensureConfigDir();
     const { config: parsedConfig, error } = parseConfig(configPath);
     if (error) {
-      return { success: false, configPath, error: `Failed to parse config: ${error}` };
+      return {
+        success: false,
+        configPath,
+        error: `Failed to parse config: ${error}`
+      };
     }
     const config = parsedConfig ?? {};
     if (installConfig.hasAntigravity) {
@@ -452,7 +478,7 @@ function writeLiteConfig(installConfig) {
     const config = generateLiteConfig(installConfig);
     const tmpPath = `${configPath}.tmp`;
     const bakPath = `${configPath}.bak`;
-    const content = JSON.stringify(config, null, 2) + `
+    const content = `${JSON.stringify(config, null, 2)}
 `;
     if (existsSync2(configPath)) {
       copyFileSync(configPath, bakPath);
@@ -474,7 +500,11 @@ function disableDefaultAgents() {
     ensureConfigDir();
     const { config: parsedConfig, error } = parseConfig(configPath);
     if (error) {
-      return { success: false, configPath, error: `Failed to parse config: ${error}` };
+      return {
+        success: false,
+        configPath,
+        error: `Failed to parse config: ${error}`
+      };
     }
     const config = parsedConfig ?? {};
     const agent = config.agent ?? {};
@@ -587,10 +617,10 @@ function formatConfigSummary(config) {
   lines.push(`${BOLD}Configuration Summary${RESET}`);
   lines.push("");
   lines.push(`  ${BOLD}Preset:${RESET} ${BLUE}${preset}${RESET}`);
-  lines.push(`  ${config.hasAntigravity ? SYMBOLS.check : DIM + "\u25CB" + RESET} Antigravity`);
-  lines.push(`  ${config.hasOpenAI ? SYMBOLS.check : DIM + "\u25CB" + RESET} OpenAI`);
+  lines.push(`  ${config.hasAntigravity ? SYMBOLS.check : `${DIM}\u25CB${RESET}`} Antigravity`);
+  lines.push(`  ${config.hasOpenAI ? SYMBOLS.check : `${DIM}\u25CB${RESET}`} OpenAI`);
   lines.push(`  ${SYMBOLS.check} Opencode Zen (free models)`);
-  lines.push(`  ${config.hasTmux ? SYMBOLS.check : DIM + "\u25CB" + RESET} Tmux Integration`);
+  lines.push(`  ${config.hasTmux ? SYMBOLS.check : `${DIM}\u25CB${RESET}`} Tmux Integration`);
   return lines.join(`
 `);
 }
@@ -631,7 +661,10 @@ async function askYesNo(rl, prompt, defaultValue = "no") {
   return defaultValue;
 }
 async function runInteractiveMode(detected) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
   const totalQuestions = 2;
   try {
     console.log(`${BOLD}Question 1/${totalQuestions}:${RESET}`);

package/dist/cli/install.d.ts

@@ -1,2 +1,2 @@
-import type { InstallArgs } from "./types";
+import type { InstallArgs } from './types';
 export declare function install(args: InstallArgs): Promise<number>;

package/dist/cli/providers.d.ts

@@ -1,4 +1,4 @@
-import type { InstallConfig } from "./types";
+import type { InstallConfig } from './types';
 /**
  * Provider configurations for Google models (via Antigravity auth plugin)
  */
@@ -6,7 +6,7 @@ export declare const GOOGLE_PROVIDER_CONFIG: {
     google: {
         name: string;
         models: {
-            "gemini-3-pro-high": {
+            'gemini-3-pro-high': {
                 name: string;
                 thinking: boolean;
                 attachment: boolean;
@@ -19,7 +19,7 @@ export declare const GOOGLE_PROVIDER_CONFIG: {
                     output: string[];
                 };
             };
-            "gemini-3-flash": {
+            'gemini-3-flash': {
                 name: string;
                 attachment: boolean;
                 limit: {
@@ -31,7 +31,7 @@ export declare const GOOGLE_PROVIDER_CONFIG: {
                     output: string[];
                 };
             };
-            "claude-opus-4-5-thinking": {
+            'claude-opus-4-5-thinking': {
                 name: string;
                 attachment: boolean;
                 limit: {
@@ -43,7 +43,7 @@ export declare const GOOGLE_PROVIDER_CONFIG: {
                     output: string[];
                 };
             };
-            "claude-sonnet-4-5-thinking": {
+            'claude-sonnet-4-5-thinking': {
                 name: string;
                 attachment: boolean;
                 limit: {
@@ -109,7 +109,7 @@ export declare const MODEL_MAPPINGS: {
             readonly variant: "low";
         };
     };
-    readonly "zen-free": {
+    readonly 'zen-free': {
         readonly orchestrator: {
             readonly model: "opencode/glm-4.7-free";
         };

package/dist/cli/types.d.ts

@@ -1,4 +1,4 @@
-export type BooleanArg = "yes" | "no";
+export type BooleanArg = 'yes' | 'no';
 export interface InstallArgs {
     tui: boolean;
     antigravity?: BooleanArg;

package/dist/commands/index.d.ts

@@ -0,0 +1,4 @@
+export type CommandRenderer = (args: string) => string;
+export declare function getCommandRenderer(
+  name: string,
+): CommandRenderer | undefined;

package/dist/commands/plan.d.ts

@@ -0,0 +1 @@
+export declare function renderPlanCommand(args: string): string;

package/dist/config/constants.d.ts

@@ -1,7 +1,7 @@
 export declare const SUBAGENT_NAMES: readonly ["explorer", "librarian", "oracle", "designer", "fixer"];
 export declare const ORCHESTRATOR_NAME: "orchestrator";
 export declare const ALL_AGENT_NAMES: readonly ["orchestrator", "explorer", "librarian", "oracle", "designer", "fixer"];
-export type AgentName = typeof ALL_AGENT_NAMES[number];
+export type AgentName = (typeof ALL_AGENT_NAMES)[number];
 export declare const DEFAULT_MODELS: Record<AgentName, string>;
 export declare const POLL_INTERVAL_MS = 500;
 export declare const POLL_INTERVAL_SLOW_MS = 1000;

package/dist/config/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./schema";
-export * from "./constants";
-export { loadPluginConfig } from "./loader";
+export * from './constants';
+export { loadAgentPrompt, loadPluginConfig } from './loader';
+export * from './schema';

package/dist/config/loader.d.ts

@@ -1,4 +1,4 @@
-import { type PluginConfig } from "./schema";
+import { type PluginConfig } from './schema';
 /**
  * Load plugin configuration from user and project config files, merging them appropriately.
  *
@@ -13,3 +13,14 @@ import { type PluginConfig } from "./schema";
  * @returns Merged plugin configuration (empty object if no configs found)
  */
 export declare function loadPluginConfig(directory: string): PluginConfig;
+/**
+ * Load custom prompt for an agent from the prompts directory.
+ * Checks for {agent}.md (replaces default) and {agent}_append.md (appends to default).
+ *
+ * @param agentName - Name of the agent (e.g., "orchestrator", "explorer")
+ * @returns Object with prompt and/or appendPrompt if files exist
+ */
+export declare function loadAgentPrompt(agentName: string): {
+    prompt?: string;
+    appendPrompt?: string;
+};

package/dist/config/loader.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/config/schema.d.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from 'zod';
 export declare const AgentOverrideConfigSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
     temperature: z.ZodOptional<z.ZodNumber>;
@@ -67,4 +67,4 @@ export declare const PluginConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type PluginConfig = z.infer<typeof PluginConfigSchema>;
-export type { AgentName } from "./constants";
+export type { AgentName } from './constants';