myai-opencode 0.6.4

package/dist/mcp/context7.d.ts

@@ -0,0 +1,6 @@
+import type { RemoteMcpConfig } from './types';
+/**
+ * Context7 - official documentation lookup for libraries
+ * @see https://context7.com
+ */
+export declare const context7: RemoteMcpConfig;

package/dist/mcp/grep-app.d.ts

@@ -0,0 +1,6 @@
+import type { RemoteMcpConfig } from './types';
+/**
+ * grep.app - ultra-fast code search across GitHub repositories
+ * @see https://grep.app
+ */
+export declare const grep_app: RemoteMcpConfig;

package/dist/mcp/index.d.ts

@@ -0,0 +1,6 @@
+import type { McpConfig } from './types';
+export type { LocalMcpConfig, McpConfig, RemoteMcpConfig } from './types';
+/**
+ * Creates MCP configurations, excluding disabled ones
+ */
+export declare function createBuiltinMcps(disabledMcps?: readonly string[]): Record<string, McpConfig>;

package/dist/mcp/types.d.ts

@@ -0,0 +1,12 @@
+export type RemoteMcpConfig = {
+    type: 'remote';
+    url: string;
+    headers?: Record<string, string>;
+    oauth?: false;
+};
+export type LocalMcpConfig = {
+    type: 'local';
+    command: string[];
+    environment?: Record<string, string>;
+};
+export type McpConfig = RemoteMcpConfig | LocalMcpConfig;

package/dist/mcp/websearch.d.ts

@@ -0,0 +1,6 @@
+import type { RemoteMcpConfig } from './types';
+/**
+ * Exa AI web search - real-time web search
+ * @see https://exa.ai
+ */
+export declare const websearch: RemoteMcpConfig;

package/dist/tools/ast-grep/cli.d.ts

@@ -0,0 +1,15 @@
+import type { CliLanguage, SgResult } from './types';
+export interface RunOptions {
+    pattern: string;
+    lang: CliLanguage;
+    paths?: string[];
+    globs?: string[];
+    rewrite?: string;
+    context?: number;
+    updateAll?: boolean;
+}
+export declare function getAstGrepPath(): Promise<string | null>;
+export declare function startBackgroundInit(): void;
+export declare function runSg(options: RunOptions): Promise<SgResult>;
+export declare function isCliAvailable(): boolean;
+export declare function ensureCliAvailable(): Promise<boolean>;

package/dist/tools/ast-grep/constants.d.ts

@@ -0,0 +1,25 @@
+import { CLI_LANGUAGES } from './types';
+export declare function findSgCliPathSync(): string | null;
+export declare function getSgCliPath(): string;
+export declare function setSgCliPath(path: string): void;
+export { CLI_LANGUAGES };
+export declare const DEFAULT_TIMEOUT_MS = 300000;
+export declare const DEFAULT_MAX_OUTPUT_BYTES: number;
+export declare const DEFAULT_MAX_MATCHES = 500;
+export declare const LANG_EXTENSIONS: Record<string, string[]>;
+export interface EnvironmentCheckResult {
+    cli: {
+        available: boolean;
+        path: string;
+        error?: string;
+    };
+}
+/**
+ * Check if ast-grep CLI is available.
+ * Call this at startup to provide early feedback about missing dependencies.
+ */
+export declare function checkEnvironment(): EnvironmentCheckResult;
+/**
+ * Format environment check result as user-friendly message.
+ */
+export declare function formatEnvironmentCheck(result: EnvironmentCheckResult): string;

package/dist/tools/ast-grep/downloader.d.ts

@@ -0,0 +1,5 @@
+export declare function getCacheDir(): string;
+export declare function getBinaryName(): string;
+export declare function getCachedBinaryPath(): string | null;
+export declare function downloadAstGrep(version?: string): Promise<string | null>;
+export declare function ensureAstGrepBinary(): Promise<string | null>;

package/dist/tools/ast-grep/index.d.ts

@@ -0,0 +1,10 @@
+import type { ToolDefinition } from '@opencode-ai/plugin';
+import { ast_grep_replace, ast_grep_search } from './tools';
+export declare const builtinTools: Record<string, ToolDefinition>;
+export { ast_grep_search, ast_grep_replace };
+export { ensureCliAvailable, getAstGrepPath, isCliAvailable, startBackgroundInit, } from './cli';
+export type { EnvironmentCheckResult } from './constants';
+export { checkEnvironment, formatEnvironmentCheck } from './constants';
+export { ensureAstGrepBinary, getCacheDir, getCachedBinaryPath, } from './downloader';
+export type { CliLanguage, CliMatch, SgResult } from './types';
+export { CLI_LANGUAGES } from './types';

package/dist/tools/ast-grep/tools.d.ts

@@ -0,0 +1,3 @@
+import { type ToolDefinition } from '@opencode-ai/plugin/tool';
+export declare const ast_grep_search: ToolDefinition;
+export declare const ast_grep_replace: ToolDefinition;

package/dist/tools/ast-grep/types.d.ts

@@ -0,0 +1,30 @@
+export declare const CLI_LANGUAGES: readonly ["bash", "c", "cpp", "csharp", "css", "elixir", "go", "haskell", "html", "java", "javascript", "json", "kotlin", "lua", "nix", "php", "python", "ruby", "rust", "scala", "solidity", "swift", "typescript", "tsx", "yaml"];
+export type CliLanguage = (typeof CLI_LANGUAGES)[number];
+export interface CliMatch {
+    file: string;
+    range: {
+        byteOffset: {
+            start: number;
+            end: number;
+        };
+        start: {
+            line: number;
+            column: number;
+        };
+        end: {
+            line: number;
+            column: number;
+        };
+    };
+    lines: string;
+    text: string;
+    replacement?: string;
+    language: string;
+}
+export interface SgResult {
+    matches: CliMatch[];
+    totalMatches: number;
+    truncated: boolean;
+    truncatedReason?: 'timeout' | 'max_output_bytes' | 'max_matches';
+    error?: string;
+}

package/dist/tools/ast-grep/utils.d.ts

@@ -0,0 +1,4 @@
+import type { CliLanguage, SgResult } from './types';
+export declare function formatSearchResult(result: SgResult): string;
+export declare function formatReplaceResult(result: SgResult, isDryRun: boolean): string;
+export declare function getEmptyResultHint(pattern: string, lang: CliLanguage): string | null;

package/dist/tools/background.d.ts

@@ -0,0 +1,13 @@
+import { type PluginInput, type ToolDefinition } from '@opencode-ai/plugin';
+import type { BackgroundTaskManager } from '../background';
+import type { PluginConfig } from '../config';
+import type { TmuxConfig } from '../config/schema';
+/**
+ * Creates background task management tools for the plugin.
+ * @param _ctx - Plugin input context
+ * @param manager - Background task manager for launching and tracking tasks
+ * @param _tmuxConfig - Optional tmux configuration for session management
+ * @param _pluginConfig - Optional plugin configuration for agent variants
+ * @returns Object containing background_task, background_output, and background_cancel tools
+ */
+export declare function createBackgroundTools(_ctx: PluginInput, manager: BackgroundTaskManager, _tmuxConfig?: TmuxConfig, _pluginConfig?: PluginConfig): Record<string, ToolDefinition>;

package/dist/tools/grep/cli.d.ts

@@ -0,0 +1,3 @@
+import type { CountResult, GrepOptions, GrepResult } from './types';
+export declare function runRg(options: GrepOptions): Promise<GrepResult>;
+export declare function runRgCount(options: Omit<GrepOptions, 'context'>): Promise<CountResult[]>;

package/dist/tools/grep/constants.d.ts

@@ -0,0 +1,18 @@
+export type GrepBackend = 'rg' | 'grep';
+interface ResolvedCli {
+    path: string;
+    backend: GrepBackend;
+}
+export declare function getDataDir(): string;
+export declare function resolveGrepCli(): ResolvedCli;
+export declare function resolveGrepCliWithAutoInstall(): Promise<ResolvedCli>;
+export declare const DEFAULT_MAX_DEPTH = 20;
+export declare const DEFAULT_MAX_FILESIZE = "10M";
+export declare const DEFAULT_MAX_COUNT = 500;
+export declare const DEFAULT_MAX_COLUMNS = 1000;
+export declare const DEFAULT_CONTEXT = 2;
+export declare const DEFAULT_TIMEOUT_MS = 300000;
+export declare const DEFAULT_MAX_OUTPUT_BYTES: number;
+export declare const RG_SAFETY_FLAGS: readonly ["--no-follow", "--color=never", "--no-heading", "--line-number", "--with-filename"];
+export declare const GREP_SAFETY_FLAGS: readonly ["-n", "-H", "--color=never"];
+export {};

package/dist/tools/grep/downloader.d.ts

@@ -0,0 +1,3 @@
+export declare function findFileRecursive(dir: string, filename: string): string | null;
+export declare function downloadAndInstallRipgrep(): Promise<string>;
+export declare function getInstalledRipgrepPath(): string | null;

package/dist/tools/grep/index.d.ts

@@ -0,0 +1,5 @@
+export { runRg, runRgCount } from './cli';
+export { resolveGrepCli, resolveGrepCliWithAutoInstall } from './constants';
+export { downloadAndInstallRipgrep, getInstalledRipgrepPath, } from './downloader';
+export { grep } from './tools';
+export type { CountResult, GrepMatch, GrepOptions, GrepResult } from './types';

package/dist/tools/grep/tools.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDefinition } from '@opencode-ai/plugin/tool';
+export declare const grep: ToolDefinition;

package/dist/tools/grep/types.d.ts

@@ -0,0 +1,35 @@
+export interface GrepMatch {
+    file: string;
+    line: number;
+    text: string;
+}
+export interface GrepResult {
+    matches: GrepMatch[];
+    totalMatches: number;
+    filesSearched: number;
+    truncated: boolean;
+    error?: string;
+}
+export interface CountResult {
+    file: string;
+    count: number;
+}
+export interface GrepOptions {
+    pattern: string;
+    paths?: string[];
+    globs?: string[];
+    excludeGlobs?: string[];
+    context?: number;
+    caseSensitive?: boolean;
+    wholeWord?: boolean;
+    fixedStrings?: boolean;
+    multiline?: boolean;
+    hidden?: boolean;
+    noIgnore?: boolean;
+    fileType?: string[];
+    maxDepth?: number;
+    maxFilesize?: string;
+    maxCount?: number;
+    maxColumns?: number;
+    timeout?: number;
+}

package/dist/tools/grep/utils.d.ts

@@ -0,0 +1,2 @@
+import type { GrepResult } from './types';
+export declare function formatGrepResult(result: GrepResult): string;

package/dist/tools/index.d.ts

@@ -0,0 +1,4 @@
+export { ast_grep_replace, ast_grep_search } from './ast-grep';
+export { createBackgroundTools } from './background';
+export { grep } from './grep';
+export { lsp_diagnostics, lsp_find_references, lsp_goto_definition, lsp_rename, lspManager, } from './lsp';

package/dist/tools/lsp/client.d.ts

@@ -0,0 +1,42 @@
+import type { Diagnostic, ResolvedServer } from './types';
+declare class LSPServerManager {
+    private static instance;
+    private clients;
+    private cleanupInterval;
+    private readonly IDLE_TIMEOUT;
+    private constructor();
+    private registerProcessCleanup;
+    static getInstance(): LSPServerManager;
+    private getKey;
+    private startCleanupTimer;
+    private cleanupIdleClients;
+    getClient(root: string, server: ResolvedServer): Promise<LSPClient>;
+    releaseClient(root: string, serverId: string): void;
+    isServerInitializing(root: string, serverId: string): boolean;
+    stopAll(): Promise<void>;
+}
+export declare const lspManager: LSPServerManager;
+export declare class LSPClient {
+    private root;
+    private server;
+    private proc;
+    private connection;
+    private openedFiles;
+    private stderrBuffer;
+    private processExited;
+    private diagnosticsStore;
+    constructor(root: string, server: ResolvedServer);
+    start(): Promise<void>;
+    private startStderrReading;
+    initialize(): Promise<void>;
+    openFile(filePath: string): Promise<void>;
+    definition(filePath: string, line: number, character: number): Promise<unknown>;
+    references(filePath: string, line: number, character: number, includeDeclaration?: boolean): Promise<unknown>;
+    diagnostics(filePath: string): Promise<{
+        items: Diagnostic[];
+    }>;
+    rename(filePath: string, line: number, character: number, newName: string): Promise<unknown>;
+    isAlive(): boolean;
+    stop(): Promise<void>;
+}
+export {};

package/dist/tools/lsp/config.d.ts

@@ -0,0 +1,4 @@
+import type { ServerLookupResult } from './types';
+export declare function findServerForExtension(ext: string): ServerLookupResult;
+export declare function getLanguageId(ext: string): string;
+export declare function isServerInstalled(command: string[]): boolean;

package/dist/tools/lsp/constants.d.ts

@@ -0,0 +1,8 @@
+import type { LSPServerConfig } from './types';
+export declare const SYMBOL_KIND_MAP: Record<number, string>;
+export declare const SEVERITY_MAP: Record<number, string>;
+export declare const DEFAULT_MAX_REFERENCES = 200;
+export declare const DEFAULT_MAX_DIAGNOSTICS = 200;
+export declare const BUILTIN_SERVERS: Record<string, Omit<LSPServerConfig, 'id'>>;
+export declare const LSP_INSTALL_HINTS: Record<string, string>;
+export declare const EXT_TO_LANG: Record<string, string>;

package/dist/tools/lsp/index.d.ts

@@ -0,0 +1,3 @@
+export { lspManager } from './client';
+export { lsp_diagnostics, lsp_find_references, lsp_goto_definition, lsp_rename, } from './tools';
+export type { Diagnostic, Location, LSPServerConfig, ResolvedServer, WorkspaceEdit, } from './types';

package/dist/tools/lsp/tools.d.ts

@@ -0,0 +1,5 @@
+import { type ToolDefinition } from '@opencode-ai/plugin/tool';
+export declare const lsp_goto_definition: ToolDefinition;
+export declare const lsp_find_references: ToolDefinition;
+export declare const lsp_diagnostics: ToolDefinition;
+export declare const lsp_rename: ToolDefinition;

package/dist/tools/lsp/types.d.ts

@@ -0,0 +1,28 @@
+import type { CreateFile, DeleteFile, Diagnostic, DocumentSymbol, Location, LocationLink, Position, Range, RenameFile, SymbolInformation as SymbolInfo, TextDocumentEdit, TextDocumentIdentifier, TextEdit, VersionedTextDocumentIdentifier, WorkspaceEdit } from 'vscode-languageserver-protocol';
+export interface LSPServerConfig {
+    id: string;
+    command: string[];
+    extensions: string[];
+    disabled?: boolean;
+    env?: Record<string, string>;
+    initialization?: Record<string, unknown>;
+}
+export interface ResolvedServer {
+    id: string;
+    command: string[];
+    extensions: string[];
+    env?: Record<string, string>;
+    initialization?: Record<string, unknown>;
+}
+export type ServerLookupResult = {
+    status: 'found';
+    server: ResolvedServer;
+} | {
+    status: 'not_configured';
+    extension: string;
+} | {
+    status: 'not_installed';
+    server: ResolvedServer;
+    installHint: string;
+};
+export type { Position, Range, Location, LocationLink, Diagnostic, TextDocumentIdentifier, VersionedTextDocumentIdentifier, TextEdit, TextDocumentEdit, CreateFile, RenameFile, DeleteFile, WorkspaceEdit, SymbolInfo, DocumentSymbol, };

package/dist/tools/lsp/utils.d.ts

@@ -0,0 +1,21 @@
+import type { LSPClient } from './client';
+import type { Diagnostic, Location, LocationLink, ServerLookupResult, WorkspaceEdit } from './types';
+export declare function findWorkspaceRoot(filePath: string): string;
+export declare function uriToPath(uri: string): string;
+export declare function formatServerLookupError(result: Exclude<ServerLookupResult, {
+    status: 'found';
+}>): string;
+export declare function withLspClient<T>(filePath: string, fn: (client: LSPClient) => Promise<T>): Promise<T>;
+export declare function formatLocation(loc: Location | LocationLink): string;
+export declare function formatSymbolKind(kind: number): string;
+export declare function formatSeverity(severity: number | undefined): string;
+export declare function formatDiagnostic(diag: Diagnostic): string;
+export declare function filterDiagnosticsBySeverity(diagnostics: Diagnostic[], severityFilter?: 'error' | 'warning' | 'information' | 'hint' | 'all'): Diagnostic[];
+export interface ApplyResult {
+    success: boolean;
+    filesModified: string[];
+    totalEdits: number;
+    errors: string[];
+}
+export declare function applyWorkspaceEdit(edit: WorkspaceEdit | null): ApplyResult;
+export declare function formatApplyResult(result: ApplyResult): string;

package/dist/utils/agent-variant.d.ts

@@ -0,0 +1,47 @@
+import type { PluginConfig } from '../config';
+/**
+ * Normalizes an agent name by trimming whitespace and removing the optional @ prefix.
+ *
+ * @param agentName - The agent name to normalize (e.g., "@oracle" or "oracle")
+ * @returns The normalized agent name without @ prefix and trimmed of whitespace
+ *
+ * @example
+ * normalizeAgentName("@oracle") // returns "oracle"
+ * normalizeAgentName("  explore  ") // returns "explore"
+ */
+export declare function normalizeAgentName(agentName: string): string;
+/**
+ * Resolves the variant configuration for a specific agent.
+ *
+ * Looks up the agent's variant in the plugin configuration. Returns undefined if:
+ * - No config is provided
+ * - The agent has no variant configured
+ * - The variant is not a string
+ * - The variant is empty or whitespace-only
+ *
+ * @param config - The plugin configuration object
+ * @param agentName - The name of the agent (with or without @ prefix)
+ * @returns The trimmed variant string, or undefined if no valid variant is found
+ *
+ * @example
+ * resolveAgentVariant(config, "@oracle") // returns "high" if configured
+ */
+export declare function resolveAgentVariant(config: PluginConfig | undefined, agentName: string): string | undefined;
+/**
+ * Applies a variant to a request body if the body doesn't already have one.
+ *
+ * This function will NOT override an existing variant in the body. If no variant
+ * is provided or the body already has a variant, the original body is returned.
+ *
+ * @template T - The type of the body object, must have an optional variant property
+ * @param variant - The variant string to apply (or undefined)
+ * @param body - The request body object
+ * @returns The body with the variant applied (new object) or the original body unchanged
+ *
+ * @example
+ * applyAgentVariant("high", { agent: "oracle" }) // returns { agent: "oracle", variant: "high" }
+ * applyAgentVariant("high", { agent: "oracle", variant: "low" }) // returns original body with variant: "low"
+ */
+export declare function applyAgentVariant<T extends {
+    variant?: string;
+}>(variant: string | undefined, body: T): T;

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from './agent-variant';
+export { log } from './logger';
+export * from './polling';
+export * from './tmux';
+export { extractZip } from './zip-extractor';

package/dist/utils/logger.d.ts

@@ -0,0 +1 @@
+export declare function log(message: string, data?: unknown): void;

package/dist/utils/polling.d.ts

@@ -0,0 +1,21 @@
+export interface PollOptions {
+    pollInterval?: number;
+    maxPollTime?: number;
+    stableThreshold?: number;
+    signal?: AbortSignal;
+}
+export interface PollResult<T> {
+    success: boolean;
+    data?: T;
+    timedOut?: boolean;
+    aborted?: boolean;
+}
+/**
+ * Generic polling utility that waits for a condition to be met.
+ * Returns when the condition is satisfied or timeout/abort occurs.
+ */
+export declare function pollUntilStable<T>(fetchFn: () => Promise<T>, isStable: (current: T, previous: T | null, stableCount: number) => boolean, opts?: PollOptions): Promise<PollResult<T>>;
+/**
+ * Simple delay utility
+ */
+export declare function delay(ms: number): Promise<void>;

package/dist/utils/tmux.d.ts

@@ -0,0 +1,32 @@
+import type { TmuxConfig } from '../config/schema';
+/**
+ * Reset the server availability cache (useful when server might have started)
+ */
+export declare function resetServerCheck(): void;
+/**
+ * Get cached tmux path, initializing if needed
+ */
+export declare function getTmuxPath(): Promise<string | null>;
+/**
+ * Check if we're running inside tmux
+ */
+export declare function isInsideTmux(): boolean;
+export interface SpawnPaneResult {
+    success: boolean;
+    paneId?: string;
+}
+/**
+ * Spawn a new tmux pane running `opencode attach <serverUrl> --session <sessionId>`
+ * This connects the new TUI to the existing server so it receives streaming updates.
+ * After spawning, applies the configured layout to auto-rebalance all panes.
+ * Returns the pane ID so it can be closed later.
+ */
+export declare function spawnTmuxPane(sessionId: string, description: string, config: TmuxConfig, serverUrl: string): Promise<SpawnPaneResult>;
+/**
+ * Close a tmux pane by its ID and reapply layout to rebalance remaining panes
+ */
+export declare function closeTmuxPane(paneId: string): Promise<boolean>;
+/**
+ * Start background check for tmux availability
+ */
+export declare function startTmuxCheck(): void;

package/dist/utils/zip-extractor.d.ts

@@ -0,0 +1 @@
+export declare function extractZip(archivePath: string, destDir: string): Promise<void>;

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "myai-opencode",
+  "version": "0.6.4",
+  "description": "Lightweight agent orchestration plugin for OpenCode",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "myai-opencode": "./dist/cli/index.js"
+  },
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "ai",
+    "agents",
+    "orchestration",
+    "llm",
+    "claude",
+    "gpt",
+    "gemini"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alvinunreal/oh-my-opencode-slim"
+  },
+  "bugs": {
+    "url": "https://github.com/alvinunreal/oh-my-opencode-slim/issues"
+  },
+  "homepage": "https://github.com/alvinunreal/oh-my-opencode-slim#readme",
+  "files": [
+    "dist",
+    "src/skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target bun --format esm && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm && tsc --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "lint": "biome lint .",
+    "format": "biome format . --write",
+    "check": "biome check --write .",
+    "check:ci": "biome check .",
+    "dev": "bun run build && opencode",
+    "prepublishOnly": "bun run build",
+    "release:patch": "npm version patch && git push --follow-tags && npm publish",
+    "release:minor": "npm version minor && git push --follow-tags && npm publish",
+    "release:major": "npm version major && git push --follow-tags && npm publish"
+  },
+  "dependencies": {
+    "@ast-grep/cli": "^0.40.0",
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "@opencode-ai/plugin": "^1.1.19",
+    "@opencode-ai/sdk": "^1.1.19",
+    "vscode-jsonrpc": "^8.2.0",
+    "vscode-languageserver-protocol": "^3.17.5",
+    "zod": "^4.1.8"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.11",
+    "bun-types": "latest",
+    "typescript": "^5.7.3"
+  },
+  "trustedDependencies": [
+    "@ast-grep/cli"
+  ]
+}

package/src/skills/cartography/README.md

@@ -0,0 +1,57 @@
+# Cartography Skill
+
+Repository understanding and hierarchical codemap generation.
+
+## Overview
+
+Cartography helps orchestrators map and understand codebases by:
+
+1. Selecting relevant code/config files using LLM judgment
+2. Creating `.slim/cartography.json` for change tracking
+3. Generating empty `codemap.md` templates for explorers to fill in
+
+## Commands
+
+```bash
+# Initialize mapping
+python3 cartographer.py init --root /repo --include "src/**/*.ts" --exclude "node_modules/**"
+
+# Check what changed
+python3 cartographer.py changes --root /repo
+
+# Update hashes
+python3 cartographer.py update --root /repo
+```
+
+## Outputs
+
+### .slim/cartography.json
+
+```json
+{
+  "metadata": {
+    "version": "1.0.0",
+    "last_run": "2026-01-25T19:00:00Z",
+    "include_patterns": ["src/**/*.ts"],
+    "exclude_patterns": ["node_modules/**"]
+  },
+  "file_hashes": {
+    "src/index.ts": "abc123..."
+  },
+  "folder_hashes": {
+    "src": "def456..."
+  }
+}
+```
+
+### codemap.md (per folder)
+
+Empty templates created in each folder for explorers to fill with:
+- Responsibility
+- Design patterns
+- Data/control flow
+- Integration points
+
+## Installation
+
+Installed automatically via oh-my-opencode-slim installer when custom skills are enabled.