oh-my-opencode-slim 1.0.7 → 1.1.1

package/README.md

@@ -1,6 +1,10 @@
 <div align="center">
-  <img src="img/team.jpeg" alt="Pantheon agents" style="border-radius: 10px;">
-  <p><i>Seven 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>
+  <a href="https://github.com/alvinunreal/oh-my-opencode-slim/stargazers">
+    <img src="img/4k.png" alt="4K GitHub Stars Milestone" style="border-radius: 10px;">
+  </a>
+  <h3>🎉 4,000+ Stars! Thank you! 🎉</h3>
+  <p><i>We are incredibly grateful to our community for helping us reach this milestone.<br>The Pantheon grows stronger every day because of your feedback, contributions, and support!</i></p>
+
   <p><b>Open Multi Agent Suite</b> · Mix any models · Auto delegate tasks</p>
 
   <p><sub>by <b>Boring Dystopia Development</b></sub></p>
@@ -39,8 +43,10 @@ bunx oh-my-opencode-slim@latest install
 
 The installer also registers the companion TUI plugin in OpenCode's
 `tui.json`, which adds a small sidebar showing specialist-agent status plus
-active/reusable task sessions. For manual setups, add `oh-my-opencode-slim` to
-the `plugin` array in both `opencode.json` and `tui.json`.
+active/reusable task sessions. It also warms OpenCode's plugin cache so bunx
+installs keep loading even after temporary directories are cleaned up. For
+manual setups, add `oh-my-opencode-slim` to the `plugin` array in both
+`opencode.json` and `tui.json`.
 
 ### Getting Started
 
@@ -486,9 +492,12 @@ Use this section as a map: start with installation, then jump to features, confi
 | **[Council](docs/council.md)** | Run multiple models in parallel and synthesize a single answer with `@council` |
 | **[Multiplexer Integration](docs/multiplexer-integration.md)** | Watch agents work live in Tmux or Zellij panes |
 | **[Session Management](docs/session-management.md)** | Reuse recent child-agent sessions with short aliases instead of starting over |
+| **[Session Goal](docs/session-goal.md)** | Pin a session objective with `/goal` so todos, delegation, and verification stay aligned |
 | **[Todo Continuation](docs/todo-continuation.md)** | Auto-continue orchestrator sessions with cooldowns and safety checks |
 | **[Preset Switching](docs/preset-switching.md)** | Switch agent model presets at runtime with `/preset` |
+| **[Subtask](docs/subtask.md)** | Run a bounded child worker with `/subtask` and return a structured summary to the main session |
 | **[Codemap](docs/codemap.md)** | Generate hierarchical codemaps to understand large codebases faster |
+| **[Clonedeps](docs/clonedeps.md)** | Clone selected dependency source into an ignored local workspace for inspection |
 | **[Interview](docs/interview.md)** | Turn rough ideas into a structured markdown spec through a browser-based Q&A flow |
 | **[Divoom Display](docs/divoom.md)** | Mirror orchestrator and specialist-agent activity to a Divoom MiniToo Bluetooth display |
 
@@ -498,7 +507,7 @@ Use this section as a map: start with installation, then jump to features, confi
 |-----|----------------|
 | **[Configuration](docs/configuration.md)** | Config file locations, JSONC support, prompt overrides, and full option reference |
 | **[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` |
+| **[Skills](docs/skills.md)** | Built-in and recommended skills such as `simplify`, `agent-browser`, `codemap`, and `clonedeps` |
 | **[MCPs](docs/mcps.md)** | `websearch`, `context7`, `grep_app`, and how MCP permissions work per agent |
 | **[Tools](docs/tools.md)** | Built-in tool capabilities like `webfetch`, LSP tools, code search, and formatters |
 
@@ -519,7 +528,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-45-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-46-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 </div>
 
@@ -590,6 +599,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/gustavocaiano"><img src="https://avatars.githubusercontent.com/u/104129313?v=4?s=100" width="100px;" alt="Gustavo Caiano"/><br /><sub><b>Gustavo Caiano</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=gustavocaiano" title="Code">💻</a></td>
       <td align="center" valign="top" width="16.66%"><a href="https://github.com/ThomasMldr"><img src="https://avatars.githubusercontent.com/u/6631765?v=4?s=100" width="100px;" alt="Thomas Mulder"/><br /><sub><b>Thomas Mulder</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=ThomasMldr" title="Code">💻</a></td>
       <td align="center" valign="top" width="16.66%"><a href="https://github.com/maou-shonen"><img src="https://avatars.githubusercontent.com/u/22576780?v=4?s=100" width="100px;" alt="魔王少年(maou shonen)"/><br /><sub><b>魔王少年(maou shonen)</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=maou-shonen" title="Code">💻</a></td>
+      <td align="center" valign="top" width="16.66%"><a href="https://github.com/jelasin"><img src="https://avatars.githubusercontent.com/u/97788570?v=4?s=100" width="100px;" alt="  Jelasin"/><br /><sub><b>  Jelasin</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=jelasin" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

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

@@ -1,4 +1,5 @@
 import type { ConfigMergeResult, DetectedConfig, InstallConfig, OpenCodeConfig } from './types';
+export declare function warmOpenCodePluginCache(): Promise<ConfigMergeResult | null>;
 /**
  * Strip JSON comments (single-line // and multi-line) and trailing commas for JSONC support.
  */

package/dist/cli/index.js

@@ -15,13 +15,61 @@ import * as path from "node:path";
 import {
   copyFileSync as copyFileSync2,
   existsSync as existsSync3,
+  mkdirSync as mkdirSync3,
   readFileSync,
   renameSync,
   statSync as statSync2,
   writeFileSync
 } from "node:fs";
+import { homedir as homedir2 } from "node:os";
 import { dirname as dirname3, join as join3 } from "node:path";
 
+// src/utils/compat.ts
+import { spawn as nodeSpawn } from "node:child_process";
+var isBun = typeof globalThis.Bun !== "undefined";
+function collectStream(stream) {
+  if (!stream)
+    return () => Promise.resolve("");
+  const chunks = [];
+  stream.on("data", (chunk) => chunks.push(chunk));
+  return () => new Promise((resolve, reject) => {
+    if (!stream.readable) {
+      resolve(Buffer.concat(chunks).toString("utf-8"));
+      return;
+    }
+    stream.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+    stream.on("error", reject);
+  });
+}
+function crossSpawn(command, options) {
+  const [cmd, ...args] = command;
+  const proc = nodeSpawn(cmd, args, {
+    stdio: [
+      options?.stdin ?? "ignore",
+      options?.stdout ?? "pipe",
+      options?.stderr ?? "pipe"
+    ],
+    cwd: options?.cwd,
+    env: options?.env
+  });
+  const stdoutCollector = collectStream(proc.stdout);
+  const stderrCollector = collectStream(proc.stderr);
+  const exited = new Promise((resolve, reject) => {
+    proc.on("error", reject);
+    proc.on("close", (code) => resolve(code ?? 1));
+  });
+  return {
+    proc,
+    stdout: stdoutCollector,
+    stderr: stderrCollector,
+    exited,
+    kill: (signal) => proc.kill(signal),
+    get exitCode() {
+      return proc.exitCode;
+    }
+  };
+}
+
 // src/cli/paths.ts
 import { existsSync, mkdirSync } from "node:fs";
 import { homedir } from "node:os";
@@ -419,6 +467,12 @@ var CUSTOM_SKILLS = [
     description: "Repository understanding and hierarchical codemap generation",
     allowedAgents: ["orchestrator"],
     sourcePath: "src/skills/codemap"
+  },
+  {
+    name: "clonedeps",
+    description: "Clone important dependency source for local inspection",
+    allowedAgents: ["orchestrator"],
+    sourcePath: "src/skills/clonedeps"
   }
 ];
 function getCustomSkillsDir() {
@@ -658,10 +712,6 @@ function findPackageRoot(startPath) {
     currentPath = parentPath;
   }
 }
-function isPackageManagerInstall(path) {
-  const normalizedPath = normalizePathForMatch(path);
-  return normalizedPath.includes(`/node_modules/${PACKAGE_NAME}`);
-}
 function isLocalPackageRootEntry(entry) {
   if (!entry || entry.startsWith("file://")) {
     return false;
@@ -677,6 +727,10 @@ function isLocalPackageRootEntry(entry) {
     return false;
   }
 }
+function isPackageManagerInstall(path) {
+  const normalizedPath = normalizePathForMatch(path);
+  return normalizedPath.includes(`/node_modules/${PACKAGE_NAME}`);
+}
 function isPluginEntry(entry) {
   return entry === PACKAGE_NAME || entry.startsWith(`${PACKAGE_NAME}@`) || entry.startsWith("file://") && entry.includes(PACKAGE_NAME) || isLocalPackageRootEntry(entry);
 }
@@ -699,6 +753,104 @@ function getPluginEntry() {
     return PACKAGE_NAME;
   }
 }
+function getOpenCodePluginCacheDir() {
+  const cacheDir = process.env.XDG_CACHE_HOME?.trim() || join3(homedir2(), ".cache");
+  return join3(cacheDir, "opencode", "packages", `${PACKAGE_NAME}@latest`);
+}
+function writeOpenCodePluginCacheManifest(cacheDir) {
+  try {
+    writeFileSync(join3(cacheDir, "package.json"), JSON.stringify({
+      name: `${PACKAGE_NAME}-cache`,
+      private: true,
+      dependencies: {
+        [PACKAGE_NAME]: "latest"
+      }
+    }, null, 2));
+    return null;
+  } catch (err) {
+    return {
+      success: false,
+      configPath: cacheDir,
+      error: `Failed to write cache package.json: ${err}`
+    };
+  }
+}
+function verifyOpenCodePluginCache(cacheDir) {
+  const pluginPackageJsonPath = join3(cacheDir, "node_modules", PACKAGE_NAME, "package.json");
+  if (!existsSync3(pluginPackageJsonPath)) {
+    return {
+      success: false,
+      configPath: cacheDir,
+      error: `Cached plugin package not found at ${pluginPackageJsonPath}`
+    };
+  }
+  try {
+    const packageJson = JSON.parse(readFileSync(pluginPackageJsonPath, "utf-8"));
+    if (packageJson.name !== PACKAGE_NAME) {
+      return {
+        success: false,
+        configPath: cacheDir,
+        error: `Cached plugin package has unexpected name: ${packageJson.name}`
+      };
+    }
+  } catch (err) {
+    return {
+      success: false,
+      configPath: cacheDir,
+      error: `Failed to verify cached plugin package: ${err}`
+    };
+  }
+  return null;
+}
+async function warmOpenCodePluginCache() {
+  const cliEntryPath = process.argv[1];
+  if (!cliEntryPath) {
+    return null;
+  }
+  const packageRoot = findPackageRoot(cliEntryPath);
+  if (!packageRoot || !isPackageManagerInstall(packageRoot)) {
+    return null;
+  }
+  const cacheDir = getOpenCodePluginCacheDir();
+  try {
+    mkdirSync3(cacheDir, { recursive: true });
+  } catch (err) {
+    return {
+      success: false,
+      configPath: cacheDir,
+      error: `Failed to create OpenCode cache directory: ${err}`
+    };
+  }
+  const manifestError = writeOpenCodePluginCacheManifest(cacheDir);
+  if (manifestError)
+    return manifestError;
+  try {
+    const proc = crossSpawn(["bun", "install", "--ignore-scripts"], {
+      cwd: cacheDir,
+      stdout: "pipe",
+      stderr: "pipe"
+    });
+    await proc.exited;
+    if (proc.exitCode !== 0) {
+      const stderr = (await proc.stderr()).trim();
+      return {
+        success: false,
+        configPath: cacheDir,
+        error: stderr || `bun install exited with code ${proc.exitCode}`
+      };
+    }
+    const verificationError = verifyOpenCodePluginCache(cacheDir);
+    if (verificationError)
+      return verificationError;
+    return { success: true, configPath: cacheDir };
+  } catch (err) {
+    return {
+      success: false,
+      configPath: cacheDir,
+      error: `Failed to warm OpenCode cache: ${err}`
+    };
+  }
+}
 function stripJsonComments(json) {
   const commentPattern = /\\"|"(?:\\"|[^"])*"|(\/\/.*|\/\*[\s\S]*?\*\/)/g;
   const trailingCommaPattern = /\\"|"(?:\\"|[^"])*"|(,)(\s*[}\]])/g;
@@ -1205,54 +1357,6 @@ import { createInterface } from "node:readline/promises";
 // src/cli/system.ts
 import { spawnSync as spawnSync2 } from "node:child_process";
 import { statSync as statSync4 } from "node:fs";
-
-// src/utils/compat.ts
-import { spawn as nodeSpawn } from "node:child_process";
-var isBun = typeof globalThis.Bun !== "undefined";
-function collectStream(stream) {
-  if (!stream)
-    return () => Promise.resolve("");
-  const chunks = [];
-  stream.on("data", (chunk) => chunks.push(chunk));
-  return () => new Promise((resolve, reject) => {
-    if (!stream.readable) {
-      resolve(Buffer.concat(chunks).toString("utf-8"));
-      return;
-    }
-    stream.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
-    stream.on("error", reject);
-  });
-}
-function crossSpawn(command, options) {
-  const [cmd, ...args] = command;
-  const proc = nodeSpawn(cmd, args, {
-    stdio: [
-      options?.stdin ?? "ignore",
-      options?.stdout ?? "pipe",
-      options?.stderr ?? "pipe"
-    ],
-    cwd: options?.cwd,
-    env: options?.env
-  });
-  const stdoutCollector = collectStream(proc.stdout);
-  const stderrCollector = collectStream(proc.stderr);
-  const exited = new Promise((resolve, reject) => {
-    proc.on("error", reject);
-    proc.on("close", (code) => resolve(code ?? 1));
-  });
-  return {
-    proc,
-    stdout: stdoutCollector,
-    stderr: stderrCollector,
-    exited,
-    kill: (signal) => proc.kill(signal),
-    get exitCode() {
-      return proc.exitCode;
-    }
-  };
-}
-
-// src/cli/system.ts
 var cachedOpenCodePath = null;
 function resolvePathCommand(command) {
   try {
@@ -1478,6 +1582,7 @@ async function runInstall(config) {
     totalSteps += 1;
   if (config.installCustomSkills)
     totalSteps += 1;
+  totalSteps += 1;
   let step = 1;
   printStep(step++, totalSteps, "Checking OpenCode installation...");
   if (config.dryRun) {
@@ -1506,6 +1611,19 @@ async function runInstall(config) {
       handleStepResult(tuiResult, "TUI badge added");
     }
   }
+  printStep(step++, totalSteps, "Warming OpenCode plugin cache...");
+  if (config.dryRun) {
+    printInfo("Dry run mode - skipping cache warm-up");
+  } else {
+    const cacheResult = await warmOpenCodePluginCache();
+    if (cacheResult === null) {
+      printInfo("Local development install - cache warm-up not required");
+    } else if (!cacheResult.success) {
+      printInfo(`Skipped cache warm-up: ${cacheResult.error}`);
+    } else {
+      handleStepResult(cacheResult, "OpenCode cache warmed");
+    }
+  }
   printStep(step++, totalSteps, "Disabling OpenCode default agents...");
   if (config.dryRun) {
     printInfo("Dry run mode - skipping agent disabling");

package/dist/goal/index.d.ts

@@ -0,0 +1,3 @@
+export { createGoalManager, type GoalManager } from './manager';
+export { GoalStore, getGoalStorePath } from './store';
+export type { GoalCheckpoint, GoalConfig, GoalRecord, GoalStatus, } from './types';

package/dist/goal/manager.d.ts

@@ -0,0 +1,41 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { GoalConfig } from './types';
+interface MessagePart {
+    type?: string;
+    text?: string;
+    [key: string]: unknown;
+}
+interface ChatTransformMessage {
+    info: {
+        role?: string;
+        agent?: string;
+        sessionID?: string;
+    };
+    parts: MessagePart[];
+}
+export declare function createGoalManager(ctx: PluginInput, config?: GoalConfig): {
+    registerCommand: (opencodeConfig: Record<string, unknown>) => void;
+    handleCommandExecuteBefore: (input: {
+        command: string;
+        sessionID: string;
+        arguments: string;
+    }, output: {
+        parts: Array<{
+            type: string;
+            text?: string;
+        }>;
+    }) => Promise<void>;
+    handleMessagesTransform: (output: {
+        messages: ChatTransformMessage[];
+    }) => Promise<void>;
+    handleEvent: (input: {
+        event: {
+            type: string;
+            properties?: Record<string, unknown>;
+        };
+    }) => Promise<void>;
+    hasActiveGoal: (sessionID: string) => boolean;
+    hasRunningGoal: (sessionID: string) => boolean;
+};
+export type GoalManager = ReturnType<typeof createGoalManager>;
+export {};

package/dist/goal/prompts.d.ts

@@ -0,0 +1,4 @@
+import type { GoalRecord } from './types';
+export declare function buildGoalContext(goal: GoalRecord): string;
+export declare function buildGoalContinuationPrompt(goal: GoalRecord): string;
+export declare function buildGoalStartPrompt(goal: GoalRecord): string;

package/dist/goal/store.d.ts

@@ -0,0 +1,15 @@
+import type { GoalRecord } from './types';
+interface GoalStoreSnapshot {
+    version: 1;
+    goals: GoalRecord[];
+}
+export declare function getGoalStorePath(): string;
+export declare class GoalStore {
+    read(): GoalStoreSnapshot;
+    write(snapshot: GoalStoreSnapshot): void;
+    list(): GoalRecord[];
+    save(goal: GoalRecord): void;
+    findActiveBySession(sessionID: string): GoalRecord | undefined;
+    findLatestByDirectory(directory: string): GoalRecord | undefined;
+}
+export {};

package/dist/goal/types.d.ts

@@ -0,0 +1,28 @@
+export type GoalStatus = 'running' | 'paused' | 'blocked' | 'completed' | 'archived';
+export interface GoalCheckpoint {
+    id: string;
+    createdAt: string;
+    note: string;
+}
+export interface GoalRecord {
+    version: 1;
+    id: string;
+    directory: string;
+    sessionID: string;
+    objective: string;
+    stopCondition?: string;
+    validationCommands: string[];
+    artifacts: string[];
+    status: GoalStatus;
+    createdAt: string;
+    updatedAt: string;
+    maxCycles: number;
+    completedCycles: number;
+    checkpoints: GoalCheckpoint[];
+    lastError?: string;
+}
+export interface GoalConfig {
+    maxCycles?: number;
+    cooldownMs?: number;
+    shouldManageSession?: (sessionID: string) => boolean;
+}

package/dist/hooks/index.d.ts

@@ -9,5 +9,6 @@ export { processImageAttachments } from './image-hook';
 export { createJsonErrorRecoveryHook } from './json-error-recovery';
 export { createPhaseReminderHook } from './phase-reminder';
 export { createPostFileToolNudgeHook } from './post-file-tool-nudge';
+export { createSessionGoalHook } from './session-goal';
 export { createTaskSessionManagerHook } from './task-session-manager';
 export { createTodoContinuationHook } from './todo-continuation';

package/dist/hooks/session-goal/index.d.ts

@@ -0,0 +1,38 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { PluginConfig } from '../../config';
+interface GoalState {
+    text: string;
+    source?: 'manual' | 'interview';
+    sourcePath?: string;
+    inheritedFrom?: string;
+    createdAt: number;
+}
+interface SystemTransformOutput {
+    system: string[];
+}
+export declare function createSessionGoalHook(ctx: PluginInput, config: PluginConfig, options?: {
+    getAgentName?: (sessionID: string) => string | undefined;
+}): {
+    registerCommand: (config: Record<string, unknown>) => void;
+    handleCommandExecuteBefore: (input: {
+        command: string;
+        sessionID: string;
+        arguments: string;
+    }, output: {
+        parts: Array<{
+            type: string;
+            text?: string;
+        }>;
+    }) => Promise<void>;
+    handleEvent: (input: {
+        event: {
+            type: string;
+            properties?: Record<string, unknown>;
+        };
+    }) => void;
+    handleSystemTransform: (input: {
+        sessionID?: string;
+    }, output: SystemTransformOutput) => void;
+    getGoal: (sessionID: string) => GoalState | undefined;
+};
+export {};