oh-my-opencode-slim 0.2.1 → 0.3.0

package/README.md

@@ -4,13 +4,42 @@
 
 **A lightweight, powerful agent orchestration plugin for OpenCode**
 
-<img src="img/hero.png" alt="Agent Orchestration - Hub and Spoke Model" width="520">
+<img src="img/team.png" alt="The Pantheon - Agent Team" width="600">
 
 *Transform your AI assistant into a manager capable of delegating complex tasks to specialized sub-agents, running searches in the background, and managing multi-step workflows with ease.*
 
 </div>
 
-> Slimmed-down fork of [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) — focused on core agent orchestration without the extra bells and whistles.
+> Slimmed-down fork of [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) - focused on core agent orchestration without the extra bells and whistles.
+
+> **[Antigravity](https://antigravity.ai) subscription recommended.** The pantheon is tuned for Antigravity's model routing. Other providers work, but you'll get the best experience with Antigravity.
+
+---
+
+## ⚡ Quick Navigation
+
+- [🚀 **Installation**](#installation)
+  - [For Humans](#for-humans)
+  - [For LLM Agents](#for-llm-agents)
+- [🏗️ **Architecture & Flow**](#architecture--flow)
+- [🏛️ **Meet the Pantheon**](#meet-the-pantheon)
+  - [The Orchestrator](#the-orchestrator---architect-of-realms)
+  - [The Explorer](#the-explorer---pathfinder)
+  - [The Oracle](#the-oracle---seer-beyond-the-stack-trace)
+  - [The Librarian](#the-librarian---keeper-of-infinite-scrolls)
+  - [The Designer](#the-designer---artisan-of-interfaces)
+  - [The Scribe](#the-scribe---chronicle-keeper)
+  - [The Visionary](#the-visionary---reader-of-pixels)
+  - [The Minimalist](#the-minimalist---destroyer-of-bloat)
+- [🛠️ **Tools & Capabilities**](#tools--capabilities)
+  - [Tmux Integration](#tmux-integration)
+  - [Quota Tool](#quota-tool)
+  - [Background Tasks](#background-tasks)
+  - [LSP Tools](#lsp-tools)
+  - [Code Search Tools](#code-search-tools)
+- [🔌 **MCP Servers**](#mcp-servers)
+- [⚙️ **Configuration**](#configuration)
+- [🗑️ **Uninstallation**](#uninstallation)
 
 ---
 
@@ -98,23 +127,16 @@ The installer automatically:
 
 #### Step 4: Authentication
 
-After installation, guide the user:
+After installation, guide the user to log in for each enabled provider:
 
-**For Antigravity:**
 ```bash
 opencode auth login
-# Select: Google → OAuth with Google (Antigravity)
 ```
 
-**For OpenAI:**
-```bash
-export OPENAI_API_KEY="sk-..."
-```
-
-**For Cerebras:**
-```bash
-export CEREBRAS_API_KEY="..."
-```
+The user should select:
+- **For Antigravity**: Google → OAuth with Google (Antigravity)
+- **For OpenAI**: OpenAI → Enter API Key
+- **For Cerebras**: Cerebras → Enter API Key
 
 ---
 
@@ -151,6 +173,8 @@ The plugin follows a "Hub and Spoke" model:
 
 ### The Flow of a Request
 
+<img src="img/intro.png" alt="Orchestration Flow" width="800">
+
 1. **User Prompt**: "Refactor the auth logic and update the docs."
 2. **Orchestrator**: Creates a TODO list.
 3. **Delegation**:
@@ -161,25 +185,228 @@ The plugin follows a "Hub and Spoke" model:
 
 ---
 
-## Agents
+## Meet the Pantheon
+
+<br clear="both">
+
+### The Orchestrator - *Architect of Realms*
+
+<a href="src/agents/orchestrator.ts"><img src="img/orchestrator.png" alt="The Orchestrator" align="right" width="240"></a>
+
+> **The Orchestrator** was born when the first codebase collapsed under its own complexity. Neither god nor mortal would claim responsibility-so The Orchestrator emerged from the void, forging order from chaos. They don't merely command armies; they fight alongside them. Every line of code passes through their hands before they decide which lesser deity deserves a piece of the puzzle.
+
+**Role:** Supreme executor, delegator, and overseer - **Model:** `google/claude-opus-4-5-thinking`
+
+Write and execute code, orchestrate multi-agent workflows, parse the unspoken from the spoken, summon specialists mid-battle. Shape reality directly-and assign realms to others when the universe grows too vast.
+
+<br clear="both">
+
+---
+
+### The Explorer - *Pathfinder*
+
+<a href="src/agents/explore.ts"><img src="img/explorer.png" alt="The Explorer" align="right" width="240"></a>
+
+> **The Explorer** moves through codebases like wind through trees-swift, silent, everywhere at once. When The Orchestrator whispers "find me the auth module," The Explorer has already returned with forty file paths and a map. They were born from the first `grep` command, evolved beyond it, and now see patterns mortals miss.
 
-| Agent | Role | Default Model | Best Used For |
-| :--- | :--- | :--- | :--- |
-| **orchestrator** | Manager | `google/claude-opus-4-5-thinking` | Planning, task delegation, and overall coordination. |
-| **oracle** | Architect | `openai/gpt-5.2-codex` | Complex debugging, architectural decisions, and code reviews. |
-| **explore** | Searcher | `cerebras/zai-glm-4.6` | Fast codebase grep, finding patterns, and locating definitions. |
-| **librarian** | Researcher | `google/gemini-3-flash` | External library docs, GitHub examples, and API research. |
-| **frontend-ui-ux-engineer** | Designer | `google/gemini-3-flash` | Visual changes, CSS/styling, and React/Vue component polish. |
-| **document-writer** | Scribe | `google/gemini-3-flash` | Technical documentation, READMEs, and inline code comments. |
-| **multimodal-looker** | Visionary | `google/gemini-3-flash` | Analyzing screenshots, wireframes, or UI designs. |
-| **code-simplicity-reviewer** | Minimalist | `google/claude-opus-4-5-thinking` | Ruthless code simplification and YAGNI principle enforcement. |
+**Role:** Codebase reconnaissance - **Model:** `cerebras/zai-glm-4.6`
+
+Regex search, AST pattern matching, file discovery, parallel exploration. Read-only: they chart the territory; others conquer it.
+
+<br clear="both">
+
+---
+
+### The Oracle - *Seer Beyond the Stack Trace*
+
+<a href="src/agents/oracle.ts"><img src="img/oracle.png" alt="The Oracle" align="right" width="240"></a>
+
+> **The Oracle** does not code-they *know*. When bugs defy logic and architectures crumble, The Oracle gazes into the abyss of your codebase and speaks truth. They've seen a thousand systems rise and fall. They'll tell you which path leads to ruin, and which to production.
+
+**Role:** Strategic advisor and debugger of last resort - **Model:** `openai/gpt-5.2-codex`
+
+Root cause analysis, architecture review, debugging guidance, tradeoff analysis. Read-only: Oracles advise; they don't intervene.
+
+<br clear="both">
+
+---
+
+### The Librarian - *Keeper of Infinite Scrolls*
+
+<a href="src/agents/librarian.ts"><img src="img/librarian.png" alt="The Librarian" align="right" width="240"></a>
+
+> **The Librarian** guards a library with no walls-every GitHub repo, every npm package, every StackOverflow answer ever written. Ask them "how does React handle concurrent rendering?" and they'll return with official docs, real-world examples, and a warning about the footgun you're about to step on.
+
+**Role:** External knowledge retrieval - **Model:** `google/gemini-3-flash`
+
+Documentation lookup, GitHub code search, library research, best practice retrieval. Read-only: they fetch wisdom; implementation is for others.
+
+<br clear="both">
+
+---
+
+### The Designer - *Artisan of Interfaces*
+
+<a href="src/agents/frontend.ts"><img src="img/designer.png" alt="The Designer" align="right" width="240"></a>
+
+> **The Designer** believes code should be beautiful-and so should everything it renders. Born from the frustration of a thousand ugly MVPs, they wield CSS like a brush and components like clay. Hand them a feature request; receive a masterpiece. They don't do "good enough."
+
+**Role:** UI/UX implementation and visual excellence - **Model:** `google/gemini-3-flash`
+
+Modern responsive design, CSS/Tailwind mastery, micro-animations, component architecture. Visual excellence over code perfection-beauty is the priority.
+
+<br clear="both">
+
+---
+
+### The Scribe - *Chronicle Keeper*
+
+<a href="src/agents/document-writer.ts"><img src="img/scribe.png" alt="The Scribe" align="right" width="240"></a>
+
+> **The Scribe** was there when the first README was written-and wept, for it was incomplete. They have devoted eternity to the sacred art of documentation: clear, scannable, honest. While others ship features, The Scribe ensures those features are understood. Every code example works. Every explanation enlightens.
+
+**Role:** Technical documentation and knowledge capture - **Model:** `google/gemini-3-flash`
+
+README crafting, API documentation, architecture docs, inline comments that don't insult your intelligence. Match existing style; focus on "why," not just "what."
+
+<br clear="both">
+
+---
+
+### The Visionary - *Reader of Pixels*
+
+<a href="src/agents/multimodal.ts"><img src="img/multimodal.png" alt="The Visionary" align="right" width="240"></a>
+
+> **The Visionary** sees what others cannot-literally. Screenshots, wireframes, diagrams, PDFs: all are text to them. When a designer throws a Figma mockup at the team and vanishes, The Visionary translates vision into specification. They read the unreadable and describe the indescribable.
+
+**Role:** Image and visual content analysis - **Model:** `google/gemini-3-flash`
+
+Extract text from images, interpret diagrams, analyze UI screenshots, summarize visual documents. Report what they observe; inference is for others.
+
+<br clear="both">
+
+---
+
+### The Minimalist - *Destroyer of Bloat*
+
+<a href="src/agents/simplicity-reviewer.ts"><img src="img/code-simplicity.png" alt="The Minimalist" align="right" width="240"></a>
+
+> **The Minimalist** has one sacred truth: every line of code is a liability. They hunt abstractions that serve no purpose, defensive checks that defend nothing, and "clever" solutions that will haunt you in six months. Where others add, The Minimalist subtracts-ruthlessly, joyfully, necessarily.
+
+**Role:** Code simplification and YAGNI enforcement - **Model:** `google/claude-opus-4-5-thinking`
+
+Identify unnecessary complexity, challenge premature abstractions, estimate LOC reduction, enforce minimalism. Read-only: they judge; The Orchestrator executes the sentence.
+
+<br clear="both">
 
 ---
 
 ## Tools & Capabilities
 
+### Tmux Integration
+
+<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
+
+| 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 |
+
+#### What You Get
+
+- **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
+
+#### Quick Setup
+
+**1. Enable the OpenCode HTTP server** (one-time setup)
+
+Add to your `~/.config/opencode/opencode.json`:
+
+```json
+{
+  "server": {
+    "port": 4096
+  }
+}
+```
+
+**2. Enable tmux integration in the plugin**
+
+Add to your `~/.config/opencode/oh-my-opencode-slim.json`:
+
+```json
+{
+  "tmux": {
+    "enabled": true,
+    "layout": "main-vertical",
+    "main_pane_size": 60
+  }
+}
+```
+
+**3. Run OpenCode inside tmux**
+
+```bash
+tmux
+opencode
+```
+
+That's it. When agents spawn, they'll appear in new panes.
+
+#### Layout Options
+
+| Layout | Description |
+|--------|-------------|
+| `main-vertical` | Your session on the left (60%), agents stacked on the right |
+| `main-horizontal` | Your session on top (60%), agents stacked below |
+| `tiled` | All panes in equal-sized grid |
+| `even-horizontal` | All panes side by side |
+| `even-vertical` | All panes stacked vertically |
+
+#### Configuration Reference
+
+```json
+{
+  "tmux": {
+    "enabled": true,
+    "layout": "main-vertical",
+    "main_pane_size": 60
+  }
+}
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `enabled` | boolean | `false` | Enable/disable tmux integration |
+| `layout` | string | `"main-vertical"` | Tmux layout preset |
+| `main_pane_size` | number | `60` | Size of main pane as percentage (20-80) |
+
+---
+
+### Quota Tool
+
+For Antigravity users. You can trigger this at any time by asking the agent to **"check my quota"** or **"show status."**
+
+<img src="img/quota.png" alt="Antigravity Quota" width="600">
+
+| Tool | Description |
+|------|-------------|
+| `antigravity_quota` | Check API quota for all Antigravity accounts (compact view with progress bars) |
+
+---
+
 ### Background Tasks
 
+
 The plugin provides tools to manage asynchronous work:
 
 | Tool | Description |
@@ -188,6 +415,8 @@ The plugin provides tools to manage asynchronous work:
 | `background_output` | Fetch the result of a background task by ID |
 | `background_cancel` | Abort running tasks |
 
+---
+
 ### LSP Tools
 
 Language Server Protocol integration for code intelligence:
@@ -199,6 +428,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 |
 
+---
+
 ### Code Search Tools
 
 Fast code search and refactoring:
@@ -209,14 +440,6 @@ Fast code search and refactoring:
 | `ast_grep_search` | AST-aware code pattern matching (25 languages) |
 | `ast_grep_replace` | AST-aware code refactoring with dry-run support |
 
-### Quota Tool
-
-For Antigravity users:
-
-| Tool | Description |
-|------|-------------|
-| `antigravity_quota` | Check API quota for all Antigravity accounts (compact view with progress bars) |
-
 ---
 
 ## MCP Servers

package/dist/cli/index.js

@@ -1,6 +1,9 @@
 #!/usr/bin/env bun
 // @bun
 
+// src/cli/install.ts
+import * as readline from "readline";
+
 // src/cli/config-manager.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync, statSync } from "fs";
 import { homedir } from "os";
@@ -270,6 +273,49 @@ function detectCurrentConfig() {
 }
 
 // src/cli/install.ts
+var lineReader = null;
+var lineBuffer = [];
+var lineResolvers = [];
+function initLineReader() {
+  if (lineReader)
+    return;
+  lineReader = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    terminal: process.stdin.isTTY ?? false
+  });
+  lineReader.on("line", (line) => {
+    if (lineResolvers.length > 0) {
+      const resolve = lineResolvers.shift();
+      resolve(line);
+    } else {
+      lineBuffer.push(line);
+    }
+  });
+  lineReader.on("close", () => {
+    while (lineResolvers.length > 0) {
+      const resolve = lineResolvers.shift();
+      resolve("");
+    }
+  });
+}
+async function readLine() {
+  initLineReader();
+  if (lineBuffer.length > 0) {
+    return lineBuffer.shift();
+  }
+  return new Promise((resolve) => {
+    lineResolvers.push(resolve);
+  });
+}
+function closeLineReader() {
+  if (lineReader) {
+    lineReader.close();
+    lineReader = null;
+    lineBuffer = [];
+    lineResolvers = [];
+  }
+}
 var GREEN = "\x1B[32m";
 var BLUE = "\x1B[34m";
 var YELLOW = "\x1B[33m";
@@ -308,6 +354,26 @@ function printInfo(message) {
 function printWarning(message) {
   console.log(`${SYMBOLS.warn} ${YELLOW}${message}${RESET}`);
 }
+async function checkOpenCodeInstalled() {
+  const installed = await isOpenCodeInstalled();
+  if (!installed) {
+    printError("OpenCode is not installed on this system.");
+    printInfo("Install it with:");
+    console.log(`     ${BLUE}curl -fsSL https://opencode.ai/install | bash${RESET}`);
+    return { ok: false };
+  }
+  const version = await getOpenCodeVersion();
+  printSuccess(`OpenCode ${version ?? ""} detected`);
+  return { ok: true, version: version ?? undefined };
+}
+function handleStepResult(result, successMsg) {
+  if (!result.success) {
+    printError(`Failed: ${result.error}`);
+    return false;
+  }
+  printSuccess(`${successMsg} ${SYMBOLS.arrow} ${DIM}${result.configPath}${RESET}`);
+  return true;
+}
 function formatConfigSummary(config) {
   const lines = [];
   lines.push(`${BOLD}Configuration Summary${RESET}`);
@@ -319,22 +385,15 @@ function formatConfigSummary(config) {
 `);
 }
 function validateNonTuiArgs(args) {
-  const errors = [];
-  if (args.antigravity === undefined) {
-    errors.push("--antigravity is required (values: yes, no)");
-  } else if (!["yes", "no"].includes(args.antigravity)) {
-    errors.push(`Invalid --antigravity value: ${args.antigravity} (expected: yes, no)`);
-  }
-  if (args.openai === undefined) {
-    errors.push("--openai is required (values: yes, no)");
-  } else if (!["yes", "no"].includes(args.openai)) {
-    errors.push(`Invalid --openai value: ${args.openai} (expected: yes, no)`);
-  }
-  if (args.cerebras === undefined) {
-    errors.push("--cerebras is required (values: yes, no)");
-  } else if (!["yes", "no"].includes(args.cerebras)) {
-    errors.push(`Invalid --cerebras value: ${args.cerebras} (expected: yes, no)`);
-  }
+  const requiredArgs = ["antigravity", "openai", "cerebras"];
+  const errors = requiredArgs.flatMap((key) => {
+    const value = args[key];
+    if (value === undefined)
+      return [`--${key} is required (values: yes, no)`];
+    if (!["yes", "no"].includes(value))
+      return [`Invalid --${key} value: ${value} (expected: yes, no)`];
+    return [];
+  });
   return { valid: errors.length === 0, errors };
 }
 function argsToConfig(args) {
@@ -351,15 +410,12 @@ function detectedToInitialValues(detected) {
     cerebras: detected.hasCerebras ? "yes" : "no"
   };
 }
-async function askYesNo(prompt, defaultValue = "no") {
+async function askYesNo(promptText, defaultValue = "no") {
   const defaultHint = defaultValue === "yes" ? "[Y/n]" : "[y/N]";
-  process.stdout.write(`${BLUE}${prompt}${RESET} ${defaultHint}: `);
-  const reader = Bun.stdin.stream().getReader();
-  const { value } = await reader.read();
-  reader.releaseLock();
-  const answer = value ? new TextDecoder().decode(value).trim().toLowerCase() : "";
-  if (answer === "" || answer === `
-`)
+  const fullPrompt = `${BLUE}${promptText}${RESET} ${defaultHint}: `;
+  process.stdout.write(fullPrompt);
+  const answer = (await readLine()).trim().toLowerCase();
+  if (answer === "")
     return defaultValue;
   if (answer === "y" || answer === "yes")
     return "yes";
@@ -378,57 +434,41 @@ async function runTuiMode(detected) {
   console.log(`${BOLD}Question 3/3:${RESET}`);
   const cerebras = await askYesNo("Do you have access to Cerebras API?", initial.cerebras);
   console.log();
+  closeLineReader();
   return {
     hasAntigravity: antigravity === "yes",
     hasOpenAI: openai === "yes",
     hasCerebras: cerebras === "yes"
   };
 }
-async function runInstall(args, config) {
+async function runInstall(config) {
   const detected = detectCurrentConfig();
   const isUpdate = detected.isInstalled;
   printHeader(isUpdate);
   const totalSteps = config.hasAntigravity ? 5 : 3;
   let step = 1;
   printStep(step++, totalSteps, "Checking OpenCode installation...");
-  const installed = await isOpenCodeInstalled();
-  if (!installed) {
-    printError("OpenCode is not installed on this system.");
-    printInfo("Visit https://opencode.ai/docs for installation instructions");
+  const { ok } = await checkOpenCodeInstalled();
+  if (!ok)
     return 1;
-  }
-  const version = await getOpenCodeVersion();
-  printSuccess(`OpenCode ${version ?? ""} detected`);
   printStep(step++, totalSteps, "Adding oh-my-opencode-slim plugin...");
   const pluginResult = await addPluginToOpenCodeConfig();
-  if (!pluginResult.success) {
-    printError(`Failed: ${pluginResult.error}`);
+  if (!handleStepResult(pluginResult, "Plugin added"))
     return 1;
-  }
-  printSuccess(`Plugin added ${SYMBOLS.arrow} ${DIM}${pluginResult.configPath}${RESET}`);
   if (config.hasAntigravity) {
     printStep(step++, totalSteps, "Adding auth plugins...");
     const authResult = await addAuthPlugins(config);
-    if (!authResult.success) {
-      printError(`Failed: ${authResult.error}`);
+    if (!handleStepResult(authResult, "Auth plugins configured"))
       return 1;
-    }
-    printSuccess(`Auth plugins configured ${SYMBOLS.arrow} ${DIM}${authResult.configPath}${RESET}`);
     printStep(step++, totalSteps, "Adding provider configurations...");
     const providerResult = addProviderConfig(config);
-    if (!providerResult.success) {
-      printError(`Failed: ${providerResult.error}`);
+    if (!handleStepResult(providerResult, "Providers configured"))
       return 1;
-    }
-    printSuccess(`Providers configured ${SYMBOLS.arrow} ${DIM}${providerResult.configPath}${RESET}`);
   }
   printStep(step++, totalSteps, "Writing oh-my-opencode-slim configuration...");
   const liteResult = writeLiteConfig(config);
-  if (!liteResult.success) {
-    printError(`Failed: ${liteResult.error}`);
+  if (!handleStepResult(liteResult, "Config written"))
     return 1;
-  }
-  printSuccess(`Config written ${SYMBOLS.arrow} ${DIM}${liteResult.configPath}${RESET}`);
   console.log();
   console.log(formatConfigSummary(config));
   console.log();
@@ -463,24 +503,19 @@ async function install(args) {
       return 1;
     }
     const config2 = argsToConfig(args);
-    return runInstall(args, config2);
+    return runInstall(config2);
   }
   const detected = detectCurrentConfig();
   printHeader(detected.isInstalled);
   printStep(1, 1, "Checking OpenCode installation...");
-  const installed = await isOpenCodeInstalled();
-  if (!installed) {
-    printError("OpenCode is not installed on this system.");
-    printInfo("Visit https://opencode.ai/docs for installation instructions");
+  const { ok } = await checkOpenCodeInstalled();
+  if (!ok)
     return 1;
-  }
-  const version = await getOpenCodeVersion();
-  printSuccess(`OpenCode ${version ?? ""} detected`);
   console.log();
   const config = await runTuiMode(detected);
   if (!config)
     return 1;
-  return runInstall(args, config);
+  return runInstall(config);
 }
 
 // src/cli/index.ts

package/dist/config/schema.d.ts

@@ -6,6 +6,26 @@ export declare const AgentOverrideConfigSchema: z.ZodObject<{
     prompt_append: z.ZodOptional<z.ZodString>;
     disable: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
+export declare const TmuxLayoutSchema: z.ZodEnum<{
+    "main-horizontal": "main-horizontal";
+    "main-vertical": "main-vertical";
+    tiled: "tiled";
+    "even-horizontal": "even-horizontal";
+    "even-vertical": "even-vertical";
+}>;
+export type TmuxLayout = z.infer<typeof TmuxLayoutSchema>;
+export declare const TmuxConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    layout: z.ZodDefault<z.ZodEnum<{
+        "main-horizontal": "main-horizontal";
+        "main-vertical": "main-vertical";
+        tiled: "tiled";
+        "even-horizontal": "even-horizontal";
+        "even-vertical": "even-vertical";
+    }>>;
+    main_pane_size: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type TmuxConfig = z.infer<typeof TmuxConfigSchema>;
 export type AgentOverrideConfig = z.infer<typeof AgentOverrideConfigSchema>;
 export declare const McpNameSchema: z.ZodEnum<{
     websearch: "websearch";
@@ -23,6 +43,17 @@ export declare const PluginConfigSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     disabled_agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
     disabled_mcps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tmux: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        layout: z.ZodDefault<z.ZodEnum<{
+            "main-horizontal": "main-horizontal";
+            "main-vertical": "main-vertical";
+            tiled: "tiled";
+            "even-horizontal": "even-horizontal";
+            "even-vertical": "even-vertical";
+        }>>;
+        main_pane_size: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type PluginConfig = z.infer<typeof PluginConfigSchema>;
 export type AgentName = "orchestrator" | "oracle" | "librarian" | "explore" | "frontend-ui-ux-engineer" | "document-writer" | "multimodal-looker" | "code-simplicity-reviewer";

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

@@ -1,4 +1,5 @@
 import type { PluginInput } from "@opencode-ai/plugin";
+import type { TmuxConfig } from "../config/schema";
 export interface BackgroundTask {
     id: string;
     sessionId: string;
@@ -22,7 +23,8 @@ export declare class BackgroundTaskManager {
     private client;
     private directory;
     private pollInterval?;
-    constructor(ctx: PluginInput);
+    private tmuxEnabled;
+    constructor(ctx: PluginInput, tmuxConfig?: TmuxConfig);
     launch(opts: LaunchOptions): Promise<BackgroundTask>;
     getResult(taskId: string, block?: boolean, timeout?: number): Promise<BackgroundTask | null>;
     cancel(taskId?: string): number;

package/dist/features/index.d.ts

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