oh-my-opencode-slim 0.9.15 → 1.0.1

package/README.md

@@ -23,6 +23,16 @@ To explore the agents themselves, see **[Meet the Pantheon](#meet-the-pantheon)*
 
 ### Quick Start
 
+Copy and paste this prompt to your LLM agent (Claude Code, AmpCode, Cursor, etc.):
+
+
+```
+Install and configure oh-my-opencode-slim: https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/master/README.md
+```
+
+
+### Manual Installation
+
 ```bash
 bunx oh-my-opencode-slim@latest install
 ```
@@ -61,7 +71,7 @@ The default generated configuration looks like this:
       "orchestrator": { "model": "openai/gpt-5.4", "variant": "high", "skills": ["*"], "mcps": ["*", "!context7"] },
       "oracle": { "model": "openai/gpt-5.4", "variant": "high", "skills": ["simplify"], "mcps": [] },
       "librarian": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": [], "mcps": ["websearch", "context7", "grep_app"] },
-      "explorer": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": ["cartography"], "mcps": [] },
+      "explorer": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": [], "mcps": [] },
       "designer": { "model": "openai/gpt-5.4-mini", "variant": "medium", "skills": ["agent-browser"], "mcps": [] },
       "fixer": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": [], "mcps": [] }
     }
@@ -71,7 +81,11 @@ The default generated configuration looks like this:
 
 ### For Alternative Providers
 
-To use Kimi, GitHub Copilot, ZAI Coding Plan, or a mixed-provider setup, see **[Provider Configurations](docs/provider-configurations.md)** for step-by-step config examples. If you want a ready-made starting point, check the **[Author's Preset](docs/authors-preset.md)** and **[$30 Preset](docs/thirty-dollars-preset.md)** - the `$30` preset is the best cheap setup.
+To use Kimi, GitHub Copilot, ZAI Coding Plan, or a mixed-provider setup, use **[Configuration](docs/configuration.md)** for the full reference. If you want a ready-made starting point, check the **[Author's Preset](docs/authors-preset.md)** and **[$30 Preset](docs/thirty-dollars-preset.md)** - the `$30` preset is the best cheap setup.
+
+The configuration guide also covers custom subagents via `agents.<name>`, where
+you can define both a normal `prompt` and an `orchestratorPrompt` block for
+delegation.
 
 You can also mix and match any models per agent. For model suggestions, see the **Recommended Models** listed under each agent below.
 
@@ -91,7 +105,7 @@ ping all agents
 
 <div align="center">
   <img src="img/ping.png" alt="Ping all agents" width="600">
-  <p><i>Confirmation that all six agents are online and ready.</i></p>
+  <p><i>Confirmation that all configured agents are online and ready.</i></p>
 </div>
 
 If any agent fails to respond, check your provider authentication and config file.
@@ -225,7 +239,7 @@ If any agent fails to respond, check your provider authentication and config fil
 
 ---
 
-### Council: The Chorus of Minds
+### 04. Council: The Chorus of Minds
 
 > [!NOTE]
 > **Why doesn't Orchestrator auto-call Council more often?** This is intentional. Council runs multiple models at once, so automatic delegation is kept strict because it is usually the highest-cost path in the system. In practice, Council is meant to be used manually when you want it, for example: <code>@council compare these two architectures</code>.
@@ -257,7 +271,7 @@ If any agent fails to respond, check your provider authentication and config fil
   </tr>
   <tr>
     <td colspan="2">
-      <b>Default Setup:</b> <code>Config-driven</code> — council master + councillors are chosen from your configured preset
+      <b>Default Setup:</b> <code>Config-driven</code> — councillors are chosen from your configured preset and the council agent synthesizes their responses
     </td>
   </tr>
   <tr>
@@ -274,7 +288,7 @@ If any agent fails to respond, check your provider authentication and config fil
 
 ---
 
-### 04. Librarian: The Weaver of Knowledge
+### 05. Librarian: The Weaver of Knowledge
 
 <table>
   <tr>
@@ -315,7 +329,7 @@ If any agent fails to respond, check your provider authentication and config fil
 
 ---
 
-### 05. Designer: The Guardian of Aesthetics
+### 06. Designer: The Guardian of Aesthetics
 
 <table>
   <tr>
@@ -356,7 +370,7 @@ If any agent fails to respond, check your provider authentication and config fil
 
 ---
 
-### 06. Fixer: The Last Builder
+### 07. Fixer: The Last Builder
 
 <table>
   <tr>
@@ -395,18 +409,22 @@ If any agent fails to respond, check your provider authentication and config fil
   </tr>
 </table>
 
-### 07. Observer: The Silent Witness
+---
+
+## Optional Agents
+
+### Observer: The Silent Witness
 
 > [!NOTE]
 > **Why a separate agent?** If your Orchestrator model is not multimodal, enable Observer to handle images, screenshots, PDFs, and other visual files. Observer is disabled by default and gives the Orchestrator a dedicated multimodal reader without forcing you to change your main reasoning model. Set `disabled_agents: []` and an `observer` model in your configuration.
 
 <table>
   <tr>
-    <td width="240" valign="top">
-      <b>Observer</b><br>
-      <i>Visual & binary analysis</i>
+    <td width="30%" align="center" valign="top">
+      <img src="img/observer.jpg" width="240" style="border-radius: 10px;">
+      <br><sub><i>The eye that reads what others cannot.</i></sub>
     </td>
-    <td>
+    <td width="70%" valign="top">
 
 **Read-only visual analysis** — interprets images, screenshots, PDFs, and diagrams. Returns structured observations to the orchestrator without loading raw file bytes into the main context window.
 
@@ -444,7 +462,6 @@ Use this section as a map: start with installation, then jump to features, confi
 | Doc | What it covers |
 |-----|----------------|
 | **[Installation Guide](docs/installation.md)** | Install the plugin, use CLI flags, reset config, and troubleshoot setup |
-| **[Provider Configurations](docs/provider-configurations.md)** | Configure OpenAI, Kimi, GitHub Copilot, ZAI, Fireworks AI, or mixed-provider presets |
 
 <a id="features-and-workflows"></a>
 
@@ -456,16 +473,18 @@ Use this section as a map: start with installation, then jump to features, confi
 | **[Interview](docs/interview.md)** | Turn rough ideas into a structured markdown spec through a browser-based Q&A flow |
 | **[Multiplexer Integration](docs/multiplexer-integration.md)** | Watch agents work live in Tmux or Zellij panes |
 | **[Todo Continuation](docs/todo-continuation.md)** | Auto-continue orchestrator sessions with cooldowns and safety checks |
-| **[Cartography](docs/cartography.md)** | Generate hierarchical codemaps to understand large codebases faster |
+| **[Preset Switching](docs/preset-switching.md)** | Switch agent model presets at runtime with `/preset` |
+| **[Codemap](docs/codemap.md)** | Generate hierarchical codemaps to understand large codebases faster |
 
 ### ⚙️ Config & Reference
 
 | Doc | What it covers |
 |-----|----------------|
 | **[Configuration](docs/configuration.md)** | Config file locations, JSONC support, prompt overrides, and full option reference |
-| **[Skills](docs/skills.md)** | Built-in and recommended skills such as `simplify`, `agent-browser`, and `cartography` |
+| **[Maintainer Guide](docs/maintainers.md)** | Issue triage rules, label meanings, support routing, and repo maintenance workflow |
+| **[Skills](docs/skills.md)** | Built-in and recommended skills such as `simplify`, `agent-browser`, and `codemap` |
 | **[MCPs](docs/mcps.md)** | `websearch`, `context7`, `grep_app`, and how MCP permissions work per agent |
-| **[Tools](docs/tools.md)** | Built-in tool capabilities like background tasks, `webfetch`, LSP tools, code search, and formatters |
+| **[Tools](docs/tools.md)** | Built-in tool capabilities like `webfetch`, LSP tools, code search, and formatters |
 
 ### 💡 Example Presets
 
@@ -483,7 +502,7 @@ Use this section as a map: start with installation, then jump to features, confi
   <p><sub>Every merged contribution leaves a mark on the realm.</sub></p>
 
   <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-40-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-41-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 </div>
 
@@ -547,6 +566,7 @@ Use this section as a map: start with installation, then jump to features, confi
       <td align="center" valign="top" width="16.66%"><a href="https://github.com/jwcrystal"><img src="https://avatars.githubusercontent.com/u/121911854?v=4?s=100" width="100px;" alt="jwcrystal"/><br /><sub><b>jwcrystal</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=jwcrystal" title="Code">💻</a></td>
       <td align="center" valign="top" width="16.66%"><a href="https://zenstudio.cv/"><img src="https://avatars.githubusercontent.com/u/10528635?v=4?s=100" width="100px;" alt="Nguyen Canh Toan"/><br /><sub><b>Nguyen Canh Toan</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=ZenStudioLab" title="Code">💻</a></td>
       <td align="center" valign="top" width="16.66%"><a href="https://github.com/tom-dyar"><img src="https://avatars.githubusercontent.com/u/8899513?v=4?s=100" width="100px;" alt="Thomas Dyar"/><br /><sub><b>Thomas Dyar</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=tom-dyar" title="Code">💻</a></td>
+      <td align="center" valign="top" width="16.66%"><a href="https://github.com/zuuky"><img src="https://avatars.githubusercontent.com/u/6713415?v=4?s=100" width="100px;" alt="zero"/><br /><sub><b>zero</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=zuuky" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

package/dist/agents/council.d.ts

@@ -11,18 +11,17 @@ export declare function createCouncilAgent(model: string, customPrompt?: string,
  */
 export declare function formatCouncillorPrompt(userPrompt: string, councillorPrompt?: string): string;
 /**
- * Build the synthesis prompt for the council master.
+ * Format councillor results for the council agent to synthesize.
  *
- * Formats councillor results as structured data — the agent factory
- * (council-master.ts) provides the system prompt with synthesis instructions.
- * Returns a special prompt when all councillors failed to produce output.
- *
- * @param masterPrompt - Optional per-master guidance appended to the synthesis.
+ * Formats councillor results as structured data that the council agent
+ * (which called the tool) will receive as the tool response. The council
+ * agent's system prompt contains synthesis instructions.
+ * Returns a special message when all councillors failed to produce output.
  */
-export declare function formatMasterSynthesisPrompt(originalPrompt: string, councillorResults: Array<{
+export declare function formatCouncillorResults(originalPrompt: string, councillorResults: Array<{
     name: string;
     model: string;
     status: string;
     result?: string;
     error?: string;
-}>, masterPrompt?: string): string;
+}>): string;

package/dist/agents/orchestrator.d.ts

@@ -1,4 +1,4 @@
-import type { AgentConfig } from "@opencode-ai/sdk/v2";
+import type { AgentConfig } from '@opencode-ai/sdk/v2';
 export interface AgentDefinition {
     name: string;
     displayName?: string;

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

@@ -16,6 +16,7 @@ import type { PluginInput } from '@opencode-ai/plugin';
 import type { BackgroundTaskConfig, PluginConfig } from '../config';
 import type { MultiplexerConfig } from '../config/schema';
 import { SubagentDepthTracker } from './subagent-depth';
+export declare function loadPersistedTask(taskId: string): BackgroundTask | null;
 /**
  * Represents a background task running in an isolated session.
  * Tasks are tracked from creation through completion or failure.
@@ -33,6 +34,7 @@ export interface BackgroundTask {
     startedAt: Date;
     completedAt?: Date;
     prompt: string;
+    questions: string[];
 }
 /**
  * Options for launching a new background task.
@@ -166,6 +168,15 @@ export declare class BackgroundTaskManager {
      * @returns The task object, or null if not found in memory or on disk
      */
     getResult(taskId: string): BackgroundTask | null;
+    /**
+     * Add a question relayed from a background subagent via ask_orchestrator.
+     * Resolves the task from the session ID in toolContext.
+     * Returns true if the question was recorded, false if the task wasn't found
+     * or is no longer active (completed/failed/cancelled).
+     *
+     * Questions are persisted to disk immediately for crash safety.
+     */
+    addQuestion(sessionId: string, question: string): 'recorded' | 'not-found' | 'terminal' | 'cap-reached';
     /**
      * Wait for a task to complete.
      *

package/dist/background/index.d.ts

@@ -1,3 +1,3 @@
-export { type BackgroundTask, BackgroundTaskManager, type LaunchOptions, } from './background-manager';
+export { type BackgroundTask, BackgroundTaskManager, type LaunchOptions, loadPersistedTask, } from './background-manager';
 export { MultiplexerSessionManager, TmuxSessionManager, } from './multiplexer-session-manager';
 export { SubagentDepthTracker } from './subagent-depth';