myai-opencode 0.6.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,244 @@
+<div align="center">
+  <img src="img/team.png" alt="Pantheon agents" width="420">
+  <p><i>Six divine beings emerged from the dawn of code, each an immortal master of their craft await your command to forge order from chaos and build what was once thought impossible.</i></p>
+  <p><b>Multi Agent Suite</b> · Mix any models · Auto delegate tasks</p>
+</div>
+
+---
+
+## 📦 Installation
+
+### Quick Start
+
+```bash
+bunx oh-my-opencode-slim@latest install
+```
+
+Then authenticate:
+
+```bash
+opencode auth login
+```
+
+Run `ping all agents` to verify everything works.
+
+> **💡 Models are fully customizable.** Edit `~/.config/opencode/oh-my-opencode-slim.json` to assign any model to any agent.
+
+### For LLM Agents
+
+Paste this into any coding agent:
+
+```
+Install and configure by following the instructions here:
+https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/master/README.md
+```
+
+**Detailed installation guide:** [docs/installation.md](docs/installation.md)
+
+**Additional guides:**
+- **[Antigravity Setup](docs/antigravity.md)** - Complete guide for Antigravity provider configuration  
+- **[Tmux Integration](docs/tmux-integration.md)** - Real-time agent monitoring with tmux
+
+---
+
+## 🏛️ Meet the Pantheon
+
+### 01. Orchestrator: The Embodiment Of Order
+
+<table>
+  <tr>
+    <td width="30%" align="center" valign="top">
+      <img src="img/orchestrator.png" width="240" style="border-radius: 10px;">
+      <br><sub><i>Forged in the void of complexity.</i></sub>
+    </td>
+    <td width="70%" valign="top">
+      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. It determines the optimal path to any goal, balancing speed, quality, and cost. It guides the team, summoning the right specialist for each task and delegating to achieve the best possible outcome.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Role:</b> <code>Master delegator and strategic coordinator</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Prompt:</b> <a href="src/agents/orchestrator.ts"><code>orchestrator.ts</code></a>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Models:</b> <code>kimi-for-coding/k2p5</code> <code>openai/gpt-5.2-codex</code>
+    </td>
+  </tr>
+</table>
+
+---
+
+### 02. Explorer: The Eternal Wanderer
+
+<table>
+  <tr>
+    <td width="30%" align="center" valign="top">
+      <img src="img/explorer.png" width="240" style="border-radius: 10px;">
+      <br><sub><i>The wind that carries knowledge.</i></sub>
+    </td>
+    <td width="70%" valign="top">
+      The Explorer is an immortal wanderer who has traversed the corridors of a million codebases since the dawn of programming. Cursed with the gift of eternal curiosity, they cannot rest until every file is known, every pattern understood, every secret revealed. Legends say they once searched the entire internet in a single heartbeat. They are the wind that carries knowledge, the eyes that see all, the spirit that never sleeps.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Role:</b> <code>Codebase reconnaissance</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Prompt:</b> <a href="src/agents/explorer.ts"><code>explorer.ts</code></a>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>google/gemini-3-flash</code> <code>openai/gpt-5.1-codex-mini</code>
+    </td>
+  </tr>
+</table>
+
+---
+
+### 03. Oracle: The Guardian of Paths
+
+<table>
+  <tr>
+    <td width="30%" align="center" valign="top">
+      <img src="img/oracle.png" width="240" style="border-radius: 10px;">
+      <br><sub><i>The voice at the crossroads.</i></sub>
+    </td>
+    <td width="70%" valign="top">
+      The Oracle stands at the crossroads of every architectural decision. They have walked every road, seen every destination, know every trap that lies ahead. When you stand at the precipice of a major refactor, they are the voice that whispers which way leads to ruin and which way leads to glory. They don't choose for you - they illuminate the path so you can choose wisely.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Role:</b> <code>Strategic advisor and debugger of last resort</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Prompt:</b> <a href="src/agents/oracle.ts"><code>oracle.ts</code></a>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Models:</b> <code>openai/gpt-5.2-codex</code> <code>kimi-for-coding/k2p5</code>
+    </td>
+  </tr>
+</table>
+
+---
+
+### 04. Librarian: The Weaver of Knowledge
+
+<table>
+  <tr>
+    <td width="30%" align="center" valign="top">
+      <img src="img/librarian.png" width="240" style="border-radius: 10px;">
+      <br><sub><i>The weaver of understanding.</i></sub>
+    </td>
+    <td width="70%" valign="top">
+      The Librarian was forged when humanity realized that no single mind could hold all knowledge. They are the weaver who connects disparate threads of information into a tapestry of understanding. They traverse the infinite library of human knowledge, gathering insights from every corner and binding them into answers that transcend mere facts. What they return is not information - it's understanding.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Role:</b> <code>External knowledge retrieval</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Prompt:</b> <a href="src/agents/librarian.ts"><code>librarian.ts</code></a>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Models:</b> <code>google/gemini-3-flash</code> <code>openai/gpt-5.1-codex-mini</code>
+    </td>
+  </tr>
+</table>
+
+---
+
+### 05. Designer: The Guardian of Aesthetics
+
+<table>
+  <tr>
+    <td width="30%" align="center" valign="top">
+      <img src="img/designer.png" width="240" style="border-radius: 10px;">
+      <br><sub><i>Beauty is essential.</i></sub>
+    </td>
+    <td width="70%" valign="top">
+      The Designer is an immortal guardian of beauty in a world that often forgets it matters. They have seen a million interfaces rise and fall, and they remember which ones were remembered and which were forgotten. They carry the sacred duty to ensure that every pixel serves a purpose, every animation tells a story, every interaction delights. Beauty is not optional - it's essential.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Role:</b> <code>UI/UX implementation and visual excellence</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Prompt:</b> <a href="src/agents/designer.ts"><code>designer.ts</code></a>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Models:</b> <code>google/gemini-3-flash</code>
+    </td>
+  </tr>
+</table>
+
+---
+
+### 06. Fixer: The Last Builder
+
+<table>
+  <tr>
+    <td width="30%" align="center" valign="top">
+      <img src="img/fixer.png" width="240" style="border-radius: 10px;">
+      <br><sub><i>The final step between vision and reality.</i></sub>
+    </td>
+    <td width="70%" valign="top">
+      The Fixer is the last of a lineage of builders who once constructed the foundations of the digital world. When the age of planning and debating began, they remained - the ones who actually build. They carry the ancient knowledge of how to turn thought into thing, how to transform specification into implementation. They are the final step between vision and reality.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Role:</b> <code>Fast implementation specialist</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Prompt:</b> <a href="src/agents/fixer.ts"><code>fixer.ts</code></a>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>google/gemini-3-flash</code> <code>openai/gpt-5.1-codex-mini</code>
+    </td>
+  </tr>
+</table>
+
+---
+
+## 📚 Documentation
+
+- **[Quick Reference](docs/quick-reference.md)** - Presets, Skills, MCPs, Tools, Configuration
+- **[Installation Guide](docs/installation.md)** - Detailed installation and troubleshooting
+- **[Cartography Skill](docs/cartography.md)** - Custom skill for repository mapping + codemap generation
+- **[Antigravity Setup](docs/antigravity.md)** - Complete guide for Antigravity provider configuration
+- **[Tmux Integration](docs/tmux-integration.md)** - Real-time agent monitoring with tmux
+
+---
+
+## 📄 License
+
+MIT

package/dist/agents/designer.d.ts

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

package/dist/agents/explorer.d.ts

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

package/dist/agents/fixer.d.ts

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

package/dist/agents/index.d.ts

@@ -0,0 +1,22 @@
+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.
+ * Instantiates the orchestrator and all subagents, applying user config and defaults.
+ *
+ * @param config - Optional plugin configuration with agent overrides
+ * @returns Array of agent definitions (orchestrator first, then subagents)
+ */
+export declare function createAgents(config?: PluginConfig): AgentDefinition[];
+/**
+ * Get agent configurations formatted for the OpenCode SDK.
+ * Converts agent definitions to SDK config format and applies classification metadata.
+ *
+ * @param config - Optional plugin configuration with agent overrides
+ * @returns Record mapping agent names to their SDK configurations
+ */
+export declare function getAgentConfigs(config?: PluginConfig): Record<string, SDKAgentConfig>;

package/dist/agents/librarian.d.ts

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

package/dist/agents/oracle.d.ts

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

package/dist/agents/orchestrator.d.ts

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

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

@@ -0,0 +1,131 @@
+/**
+ * Background Task Manager
+ *
+ * Manages long-running AI agent tasks that execute in separate sessions.
+ * Background tasks run independently from the main conversation flow, allowing
+ * the user to continue working while tasks complete asynchronously.
+ *
+ * Key features:
+ * - Fire-and-forget launch (returns task_id immediately)
+ * - Creates isolated sessions for background work
+ * - Event-driven completion detection via session.status
+ * - Start queue with configurable concurrency limit
+ * - Supports task cancellation and result retrieval
+ */
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { BackgroundTaskConfig, 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.
+ */
+export interface BackgroundTask {
+    id: string;
+    sessionId?: string;
+    description: string;
+    agent: string;
+    status: 'pending' | 'starting' | 'running' | 'completed' | 'failed' | 'cancelled';
+    result?: string;
+    error?: string;
+    config: BackgroundTaskConfig;
+    parentSessionId: string;
+    startedAt: Date;
+    completedAt?: Date;
+    prompt: string;
+}
+/**
+ * Options for launching a new background task.
+ */
+export interface LaunchOptions {
+    agent: string;
+    prompt: string;
+    description: string;
+    parentSessionId: string;
+}
+export declare class BackgroundTaskManager {
+    private tasks;
+    private tasksBySessionId;
+    private client;
+    private directory;
+    private tmuxEnabled;
+    private config?;
+    private backgroundConfig;
+    private startQueue;
+    private activeStarts;
+    private maxConcurrentStarts;
+    private completionResolvers;
+    constructor(ctx: PluginInput, tmuxConfig?: TmuxConfig, config?: PluginConfig);
+    /**
+     * Launch a new background task (fire-and-forget).
+     *
+     * Phase A (sync): Creates task record and returns immediately.
+     * Phase B (async): Session creation and prompt sending happen in background.
+     *
+     * @param opts - Task configuration options
+     * @returns The created background task with pending status
+     */
+    launch(opts: LaunchOptions): BackgroundTask;
+    /**
+     * Enqueue task for background start.
+     */
+    private enqueueStart;
+    /**
+     * Process start queue with concurrency limit.
+     */
+    private processQueue;
+    /**
+     * Start a task in the background (Phase B).
+     */
+    private startTask;
+    /**
+     * Handle session.status events for completion detection.
+     * Uses session.status instead of deprecated session.idle.
+     */
+    handleSessionStatus(event: {
+        type: string;
+        properties?: {
+            sessionID?: string;
+            status?: {
+                type: string;
+            };
+        };
+    }): Promise<void>;
+    /**
+     * Extract task result and mark complete.
+     */
+    private extractAndCompleteTask;
+    /**
+     * Complete a task and notify waiting callers.
+     */
+    private completeTask;
+    /**
+     * Send completion notification to parent session.
+     */
+    private sendCompletionNotification;
+    /**
+     * Retrieve the current state of a background task.
+     *
+     * @param taskId - The task ID to retrieve
+     * @returns The task object, or null if not found
+     */
+    getResult(taskId: string): BackgroundTask | null;
+    /**
+     * Wait for a task to complete.
+     *
+     * @param taskId - The task ID to wait for
+     * @param timeout - Maximum time to wait in milliseconds (0 = no timeout)
+     * @returns The completed task, or null if not found/timeout
+     */
+    waitForCompletion(taskId: string, timeout?: number): Promise<BackgroundTask | null>;
+    /**
+     * Cancel one or all running background tasks.
+     *
+     * @param taskId - Optional task ID to cancel. If omitted, cancels all pending/running tasks.
+     * @returns Number of tasks cancelled
+     */
+    cancel(taskId?: string): number;
+    /**
+     * Clean up all tasks.
+     */
+    cleanup(): void;
+}

package/dist/background/index.d.ts

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

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

@@ -0,0 +1,58 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { TmuxConfig } from '../config/schema';
+/**
+ * Event shape for session events
+ */
+interface SessionEvent {
+    type: string;
+    properties?: {
+        info?: {
+            id?: string;
+            parentID?: string;
+            title?: string;
+        };
+        sessionID?: string;
+        status?: {
+            type: string;
+        };
+    };
+}
+/**
+ * TmuxSessionManager tracks child sessions and spawns/closes tmux panes for them.
+ *
+ * Uses session.status events for completion detection instead of polling.
+ */
+export declare class TmuxSessionManager {
+    private client;
+    private tmuxConfig;
+    private serverUrl;
+    private sessions;
+    private pollInterval?;
+    private enabled;
+    constructor(ctx: PluginInput, tmuxConfig: TmuxConfig);
+    /**
+     * Handle session.created events.
+     * Spawns a tmux pane for child sessions (those with parentID).
+     */
+    onSessionCreated(event: SessionEvent): Promise<void>;
+    /**
+     * Handle session.status events for completion detection.
+     * Uses session.status instead of deprecated session.idle.
+     *
+     * When a session becomes idle (completed), close its pane.
+     */
+    onSessionStatus(event: SessionEvent): Promise<void>;
+    private startPolling;
+    private stopPolling;
+    /**
+     * Poll sessions for status updates (fallback for reliability).
+     * Also handles timeout and missing session detection.
+     */
+    private pollSessions;
+    private closeSession;
+    /**
+     * Clean up all tracked sessions.
+     */
+    cleanup(): Promise<void>;
+}
+export {};

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

@@ -0,0 +1,21 @@
+import type { ConfigMergeResult, DetectedConfig, InstallConfig, OpenCodeConfig } from './types';
+/**
+ * Strip JSON comments (single-line // and multi-line) and trailing commas for JSONC support.
+ */
+export declare function stripJsonComments(json: string): string;
+export declare function parseConfigFile(path: string): {
+    config: OpenCodeConfig | null;
+    error?: string;
+};
+export declare function parseConfig(path: string): {
+    config: OpenCodeConfig | null;
+    error?: string;
+};
+/**
+ * Write config to file atomically.
+ */
+export declare function writeConfig(configPath: string, config: OpenCodeConfig): void;
+export declare function addPluginToOpenCodeConfig(): Promise<ConfigMergeResult>;
+export declare function writeLiteConfig(installConfig: InstallConfig): ConfigMergeResult;
+export declare function disableDefaultAgents(): ConfigMergeResult;
+export declare function detectCurrentConfig(): DetectedConfig;

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

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

package/dist/cli/custom-skills.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A custom skill bundled in this repository.
+ * Unlike npx-installed skills, these are copied from src/skills/ to ~/.config/opencode/skills/
+ */
+export interface CustomSkill {
+    /** Skill name (folder name) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** List of agents that should auto-allow this skill */
+    allowedAgents: string[];
+    /** Source path in this repo (relative to project root) */
+    sourcePath: string;
+}
+/**
+ * Registry of custom skills bundled in this repository.
+ */
+export declare const CUSTOM_SKILLS: CustomSkill[];
+/**
+ * Get the target directory for custom skills installation.
+ */
+export declare function getCustomSkillsDir(): string;
+/**
+ * Install a custom skill by copying from src/skills/ to ~/.config/opencode/skills/
+ * @param skill - The custom skill to install
+ * @param projectRoot - Root directory of oh-my-opencode-slim project
+ * @returns True if installation succeeded, false otherwise
+ */
+export declare function installCustomSkill(skill: CustomSkill): boolean;

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};