@hiai-gg/hiai-opencode 0.1.3 → 0.1.4

package/dist/plugin/skill-discovery-config.d.ts

@@ -0,0 +1,4 @@
+import type { HiaiOpenCodeConfig } from "../config";
+import type { SkillDiscoveryConfig } from "../config/schema";
+export type ResolvedSkillDiscoveryConfig = Required<SkillDiscoveryConfig>;
+export declare function resolveSkillDiscoveryConfig(pluginConfig: HiaiOpenCodeConfig): ResolvedSkillDiscoveryConfig;

package/dist/shared/startup-diagnostics.d.ts

@@ -0,0 +1,6 @@
+import type { HiaiOpenCodeConfig, HiaiOpencodeConfig } from "../config";
+export declare function warnIfListPluginEntry(directory: string): void;
+export declare function warnMissingRequiredMcpEnv(args: {
+    pluginConfig: HiaiOpenCodeConfig;
+    platformConfig: HiaiOpencodeConfig;
+}): void;

package/hiai-opencode.json

@@ -1,32 +1,107 @@
 {
-  "_description": "hiai-opencode user configuration template. Public display names (shown to users): Bob, Coder, Strategist, Guard, Critic, Designer, Researcher, Manager, Brainstormer, Vision. Config keys (used in this file and in code) are: bob, coder, strategist, guard, critic, designer, researcher, manager, brainstormer, vision. Internal-only keys (hidden from normal users): sub, agent-skills. MCP enable/disable lives in the mcp object below; default MCP definitions live in src/mcp/registry.ts. Source model defaults: src/config/defaults.ts and src/config/models.ts.",
+  "_description": "Canonical hiai-opencode runtime config. Copy this file to .opencode/hiai-opencode.json and edit it there. This file is the user-facing source of truth for agent models, category models, MCP switches, LSP defaults, skill discovery, service auth placeholders, and local helper defaults. Model provider credentials are configured in OpenCode Connect; this file stores model IDs only.",
   "$schema": "./config/hiai-opencode.schema.json",
   "agents": {
-    "bob": { "model": "openrouter/anthropic/claude-3.5-opus" },
-    "coder": { "model": "openrouter/anthropic/claude-3.5-sonnet" },
-    "strategist": { "model": "openrouter/anthropic/claude-3.5-haiku" },
-    "guard": { "model": "openrouter/openai/gpt-4o" },
-    "critic": { "model": "openrouter/qwen/qwen2.5-72b-instruct" },
-    "designer": { "model": "openrouter/google/gemini-3.1-pro" },
-    "researcher": { "model": "openrouter/google/gemini-2.0-flash" },
-    "manager": { "model": "openrouter/google/gemini-2.0-flash" },
-    "brainstormer": { "model": "openrouter/google/gemini-2.0-flash" },
-    "vision": { "model": "openrouter/google/gemini-3.1-pro" }
+    "bob": {
+      "model": "openrouter/anthropic/claude-3.5-opus",
+      "description": "Primary orchestrator for end-to-end task execution, delegation, and high-level workflow control."
+    },
+    "coder": {
+      "model": "openrouter/anthropic/claude-3.5-sonnet",
+      "description": "High-depth executor for multi-file implementation, substantial refactors, and technical delivery."
+    },
+    "strategist": {
+      "model": "openrouter/z-ai/glm-5.1",
+      "description": "Planning and architecture agent for decomposition, sequencing, and decision framing before execution."
+    },
+    "guard": {
+      "model": "openrouter/openai/gpt-4o",
+      "description": "Execution supervisor that routes work, enforces discipline, and keeps delegated flows on track."
+    },
+    "critic": {
+      "model": "openrouter/qwen/qwen2.5-72b-instruct",
+      "description": "High-accuracy review gate for implementation quality, correctness, and plan validation."
+    },
+    "designer": {
+      "model": "openrouter/google/gemini-3.1-pro",
+      "description": "Creative visual problem-solver for high-touch UI, interaction, and brand-level interface direction."
+    },
+    "researcher": {
+      "model": "openrouter/google/gemini-2.0-flash",
+      "description": "Codebase exploration and external documentation research."
+    },
+    "platform-manager": {
+      "model": "openrouter/google/gemini-2.0-flash",
+      "description": "Manager. Unified platform management agent for session continuity, project initialization, and orchestration."
+    },
+    "brainstormer": {
+      "model": "openrouter/google/gemini-2.0-flash",
+      "description": "Idea exploration agent for divergent thinking, option generation, and concept shaping before execution."
+    },
+    "multimodal": {
+      "model": "openrouter/google/gemini-3.1-pro",
+      "description": "Vision. Multimodal analysis agent for images, PDFs, diagrams, and other non-text inputs."
+    },
+    "sub": {
+      "model": "openrouter/google/gemini-2.0-flash",
+      "description": "Hidden compatibility executor. Primary subtask execution is handled by Coder."
+    },
+    "quality-guardian": {
+      "model": "openrouter/anthropic/claude-3.5-sonnet",
+      "description": "Hidden compatibility review agent. Primary review work is handled by Critic."
+    },
+    "agent-skills": {
+      "model": "openrouter/google/gemini-2.0-flash",
+      "description": "Hidden system agent for skill registry, discovery, and capability orchestration."
+    }
   },
+  "agentRequirements": {},
   "categories": {
-    "visual-engineering": { "model": "openrouter/google/gemini-2.0-pro-exp-02-05", "variant": "high" },
-    "artistry": { "model": "openrouter/google/gemini-2.0-pro-exp-02-05", "variant": "high" },
-    "ultrabrain": { "model": "openrouter/openai/gpt-4o", "variant": "xhigh" },
-    "deep": { "model": "openrouter/anthropic/claude-3.5-sonnet", "variant": "medium" },
-    "quick": { "model": "openrouter/google/gemini-2.0-flash" },
-    "writing": { "model": "openrouter/openai/gpt-4o-mini" },
-    "git": { "model": "openrouter/google/gemini-2.0-flash" },
-    "unspecified-low": { "model": "openrouter/anthropic/claude-3.5-haiku" },
-    "unspecified-high": { "model": "openrouter/anthropic/claude-3.5-opus", "variant": "max" }
+    "visual-engineering": {
+      "model": "openrouter/google/gemini-2.0-pro-exp-02-05",
+      "variant": "high",
+      "description": "Frontend and UI systems work with design-system discipline. Uses Coder deep execution contour."
+    },
+    "artistry": {
+      "model": "openrouter/google/gemini-2.0-pro-exp-02-05",
+      "variant": "high",
+      "description": "High-effort creative problem solving beyond standard patterns. Uses Coder deep execution contour."
+    },
+    "ultrabrain": {
+      "model": "openrouter/openai/gpt-4o",
+      "variant": "xhigh",
+      "description": "Hard logic and architecture tasks. Uses Coder deep execution contour."
+    },
+    "deep": {
+      "model": "openrouter/openai/o1",
+      "variant": "medium",
+      "description": "Deep autonomous implementation with full context buildup. Uses Coder deep execution contour."
+    },
+    "quick": {
+      "model": "openrouter/google/gemini-2.0-flash",
+      "description": "Fast bounded execution: single-file fixes, typos, and simple modifications. Uses Coder fast execution contour."
+    },
+    "writing": {
+      "model": "openrouter/kimi/kimi-latest",
+      "description": "Documentation and prose tasks with bounded scope. Uses Coder fast execution contour."
+    },
+    "git": {
+      "model": "openrouter/google/gemini-2.0-flash",
+      "description": "Git, commit, diff, and repository hygiene tasks."
+    },
+    "unspecified-low": {
+      "model": "openrouter/anthropic/claude-3.5-sonnet",
+      "description": "Unclassifiable moderate tasks with bounded scope. Uses Coder fast execution contour."
+    },
+    "unspecified-high": {
+      "model": "openrouter/anthropic/claude-3.5-opus",
+      "variant": "max",
+      "description": "Unclassifiable substantial tasks across modules. Uses Coder deep execution contour."
+    }
   },
+  "categoryRequirements": {},
+  "modelFamilies": [],
   "auth": {
-    "openrouter": "{env:OPENROUTER_API_KEY}",
-    "openai": "{env:OPENAI_API_KEY}",
     "googleSearch": "{env:GOOGLE_SEARCH_API_KEY}",
     "stitch": "{env:STITCH_AI_API_KEY}",
     "firecrawl": "{env:FIRECRAWL_API_KEY}",
@@ -34,25 +109,106 @@
   },
   "ollama": {
     "enabled": false,
-    "model": "qwen3.5:4b",
-    "baseUrl": "http://localhost:11434",
+    "model": "{env:OLLAMA_MODEL:-qwen3.5:4b}",
+    "baseUrl": "{env:OLLAMA_BASE_URL:-http://localhost:11434}",
     "purpose": "helper"
   },
+  "fast_apply": {
+    "enabled": false,
+    "ollama_url": "{env:OLLAMA_BASE_URL:-http://localhost:11434}",
+    "model": "{env:OLLAMA_MODEL:-qwen3.5:4b}",
+    "timeout": 30000
+  },
   "mcp": {
-    "playwright": { "enabled": true },
-    "stitch": { "enabled": true },
-    "sequential-thinking": { "enabled": true },
-    "firecrawl": { "enabled": true },
-    "rag": { "enabled": true },
-    "mempalace": { "enabled": true },
-    "context7": { "enabled": true }
+    "playwright": {
+      "enabled": true,
+      "command": ["node", "{pluginRoot}/assets/mcp/playwright.mjs"],
+      "timeout": 600000
+    },
+    "stitch": {
+      "enabled": true,
+      "type": "remote",
+      "url": "https://stitch.googleapis.com/mcp",
+      "headers": { "X-Goog-Api-Key": "{env:STITCH_AI_API_KEY}" },
+      "timeout": 600000
+    },
+    "sequential-thinking": {
+      "enabled": true,
+      "command": ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "@modelcontextprotocol/server-sequential-thinking"],
+      "timeout": 600000
+    },
+    "firecrawl": {
+      "enabled": true,
+      "command": ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "firecrawl-mcp"],
+      "environment": { "FIRECRAWL_API_KEY": "{env:FIRECRAWL_API_KEY}" },
+      "timeout": 600000
+    },
+    "rag": {
+      "enabled": true,
+      "type": "local",
+      "command": ["node", "{pluginRoot}/assets/mcp/rag.mjs"],
+      "environment": {
+        "OPENCODE_RAG_URL": "{env:OPENCODE_RAG_URL:-http://localhost:9002/tools/search}"
+      },
+      "timeout": 600000
+    },
+    "mempalace": {
+      "enabled": true,
+      "type": "local",
+      "command": ["node", "{pluginRoot}/assets/mcp/mempalace.mjs", "--palace", "./.opencode/palace"],
+      "timeout": 600000
+    },
+    "context7": {
+      "enabled": true,
+      "type": "remote",
+      "url": "https://mcp.context7.com/mcp",
+      "headers": { "X-API-KEY": "{env:CONTEXT7_API_KEY}" },
+      "timeout": 600000
+    }
+  },
+  "skill_discovery": {
+    "config_sources": true,
+    "project_opencode": true,
+    "global_opencode": false,
+    "project_claude": false,
+    "global_claude": false,
+    "project_agents": false,
+    "global_agents": false
+  },
+  "skills": {
+    "enabled": true,
+    "disabled": []
   },
   "lsp": {
-    "typescript": { "enabled": true },
-    "python": { "enabled": true },
-    "svelte": { "enabled": true }
+    "typescript": {
+      "command": ["typescript-language-server", "--stdio"],
+      "extensions": [".ts", ".tsx", ".mts", ".cts"]
+    },
+    "svelte": {
+      "command": ["svelteserver", "--stdio"],
+      "extensions": [".svelte"]
+    },
+    "eslint": {
+      "command": ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "eslint-lsp", "--stdio"],
+      "extensions": [".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs", ".svelte"]
+    },
+    "bash": {
+      "command": ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "bash-language-server", "start"],
+      "extensions": [".sh", ".bash"]
+    },
+    "pyright": {
+      "command": ["pyright-langserver", "--stdio"],
+      "extensions": [".py"]
+    }
   },
   "subtask2": {
-    "replace_generic": true
+    "replace_generic": true,
+    "generic_return": null
+  },
+  "permissions": {
+    "read": { "*": "allow", "*.env": "deny", "*.env.*": "deny", "*.env.example": "allow" },
+    "edit": { "*": "allow" },
+    "bash": { "*": "allow" },
+    "deny_paths": ["**/backup/**", "**/secrets.*", "**/.env", "**/.env.*"]
   }
 }

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@hiai-gg/hiai-opencode",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Unified OpenCode plugin — canonical 12-agent model with bundled skills, MCP integrations, LSP, and permissions in one install.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "hiai-opencode": "./assets/cli/hiai-opencode.mjs"
+  },
   "exports": {
     ".": {
       "import": "./dist/index.js",

package/src/agents/AGENTS.md

@@ -56,9 +56,8 @@ These files run after the prompt library and can override what was authored. Alw
 
 | What to change | Edit |
 |---|---|
-| Preset definitions (`fast`, `mid`, `high`, `vision`) | `src/config/models.ts` |
-| Per-agent default model | `src/config/defaults.ts` |
-| Per-category default model | `src/config/defaults.ts` |
+| Per-agent default model | `hiai-opencode.json` |
+| Per-category default model | `hiai-opencode.json` |
 | Config schema defaults | `src/config/types.ts` |
 
 ## Prompt Measurement
@@ -72,4 +71,4 @@ Run `bun run prompts:measure` to generate snapshot files in `dist/prompt-snapsho
 3. Local helper launchers: `assets/mcp/*`
 4. NPM bootstrapper for local tools: `assets/runtime/npm-package-runner.mjs`
 
-For more detail see `AGENTS.md` (root) and `ARCHITECTURE.md` (root).
+For more detail see `AGENTS.md` (root) and `ARCHITECTURE.md` (root).

package/src/config/defaults.ts

@@ -1,89 +1,68 @@
 /**
- * Default config values for hiai-opencode
+ * Runtime defaults for hiai-opencode.
+ *
+ * Model defaults are intentionally not defined in TypeScript.
+ * The bundled hiai-opencode.json file is the single source of truth for:
+ * - agent models
+ * - category models
+ * - user-editable runtime defaults
  */
-import type { HiaiOpencodeConfig } from "./types.js";
-import { MODEL_PRESETS } from "./models.js";
-import { createDefaultMcpConfig } from "../mcp/registry.js";
-import { join } from "node:path";
+import { existsSync, readFileSync } from "node:fs"
+import { dirname, join, normalize } from "node:path"
+import type { HiaiOpencodeConfig } from "./types.js"
 
-export const defaultConfig: HiaiOpencodeConfig = {
-  agents: {
-    bob: { model: MODEL_PRESETS.high },
-    guard: { model: MODEL_PRESETS.ultrahigh },
-    strategist: { model: MODEL_PRESETS.strategist },
-    critic: { model: MODEL_PRESETS.critic },
-    coder: { model: MODEL_PRESETS.mid },
-    designer: {
-      model: "openrouter/google/gemini-3.1-pro",
-      description: "Creative visual problem-solver for high-touch UI, interaction, and brand-level interface direction. Best used when the task needs taste, composition, and design judgment rather than plain implementation. (Designer - HiaiOpenCode)",
-    },
-    sub: { model: MODEL_PRESETS.fast },
-    researcher: { model: MODEL_PRESETS.fast },
-    multimodal: { model: MODEL_PRESETS.vision },
-    "quality-guardian": { model: MODEL_PRESETS.mid },
-    "platform-manager": { model: MODEL_PRESETS.fast },
-    brainstormer: { model: MODEL_PRESETS.fast },
-    "agent-skills": { model: MODEL_PRESETS.fast },
-  },
-  agentRequirements: {},
-  categories: {
-    "visual-engineering": { model: MODEL_PRESETS.vision, variant: "high" },
-    artistry: { model: MODEL_PRESETS.vision, variant: "high" },
-    ultrabrain: { model: MODEL_PRESETS.ultrahigh, variant: "xhigh" },
-    deep: { model: MODEL_PRESETS.reasoning, variant: "medium" },
-    quick: { model: MODEL_PRESETS.fast },
-    writing: { model: MODEL_PRESETS.writing },
-    git: { model: MODEL_PRESETS.fast },
-    "unspecified-low": { model: MODEL_PRESETS.mid },
-    "unspecified-high": { model: MODEL_PRESETS.high, variant: "max" },
-  },
-  categoryRequirements: {},
+function findPluginRoot(): string {
+  const candidates = [
+    // Source tree: src/config/defaults.ts -> repo root
+    join(import.meta.dirname, "..", ".."),
+    // Built package: dist/index.js bundle -> package root
+    join(import.meta.dirname, ".."),
+    // Non-bundled compiled output: dist/config/defaults.js -> package root
+    join(import.meta.dirname, "..", ".."),
+    dirname(process.argv[1] ?? ""),
+    process.cwd(),
+  ]
 
-  mcp: createDefaultMcpConfig(),
+  for (const candidate of candidates) {
+    const root = normalize(candidate)
+    if (existsSync(join(root, "hiai-opencode.json"))) {
+      return root
+    }
+  }
 
-  lsp: {
-    typescript: {
-      command: ["typescript-language-server", "--stdio"],
-      extensions: [".ts", ".tsx", ".mts", ".cts"],
-    },
-    svelte: {
-      command: ["svelteserver", "--stdio"],
-      extensions: [".svelte"],
-    },
-    eslint: {
-      command: ["node", join(import.meta.dirname, "..", "assets", "runtime", "npm-package-runner.mjs"), "eslint-lsp", "--stdio"],
-      extensions: [".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs", ".svelte"],
-    },
-    bash: {
-      command: ["node", join(import.meta.dirname, "..", "assets", "runtime", "npm-package-runner.mjs"), "bash-language-server", "start"],
-      extensions: [".sh", ".bash"],
-    },
-    pyright: {
-      command: ["pyright-langserver", "--stdio"],
-      extensions: [".py"],
-    },
-  },
+  throw new Error(
+    "[hiai-opencode] Cannot find bundled hiai-opencode.json. The package is incomplete.",
+  )
+}
 
-  subtask2: {
-    replace_generic: true,
-    generic_return: null,
-  },
+function expandPluginRootPlaceholders(value: unknown, pluginRoot: string): unknown {
+  if (typeof value === "string") {
+    return value.replaceAll("{pluginRoot}", pluginRoot)
+  }
 
-  skills: {
-    enabled: true,
-    disabled: [],
-  },
+  if (Array.isArray(value)) {
+    return value.map((item) => expandPluginRootPlaceholders(item, pluginRoot))
+  }
 
-  permissions: {
-    read: { "*": "allow", "*.env": "deny", "*.env.*": "deny", "*.env.example": "allow" },
-    edit: { "*": "allow" },
-    bash: { "*": "allow" },
-    deny_paths: ["**/backup/**", "**/secrets.*", "**/.env", "**/.env.*"],
-  },
-  ollama: {
-    enabled: false,
-    model: "{env:OLLAMA_MODEL:-qwen3.5:4b}",
-    baseUrl: "http://localhost:11434",
-    purpose: "helper",
-  },
-};
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, entry]) => [
+        key,
+        expandPluginRootPlaceholders(entry, pluginRoot),
+      ]),
+    )
+  }
+
+  return value
+}
+
+function loadBundledDefaultConfig(): HiaiOpencodeConfig {
+  const pluginRoot = findPluginRoot()
+  const configPath = join(pluginRoot, "hiai-opencode.json")
+  const raw = readFileSync(configPath, "utf-8")
+  const parsed = JSON.parse(raw) as HiaiOpencodeConfig
+
+  return expandPluginRootPlaceholders(parsed, pluginRoot) as HiaiOpencodeConfig
+}
+
+export const defaultConfig: HiaiOpencodeConfig = loadBundledDefaultConfig()

package/src/config/index.ts

@@ -11,7 +11,6 @@
 export { loadConfig, resolveEnvVars, resolveMcpEnv } from "./loader.js";
 export { HiaiOpencodeConfigSchema } from "./platform-schema.js";
 export { defaultConfig } from "./defaults.js";
-export { MODEL_PRESETS, MODEL_ROLE_GUIDE, PROVIDER_MODEL_RULES } from "./models.js";
 export type {
   HiaiOpencodeConfig,
   AgentConfig,

package/src/config/platform-schema.ts

@@ -63,6 +63,16 @@ export const SkillsConfigSchema = z.object({
   disabled: z.array(z.string()).optional(),
 });
 
+export const SkillDiscoveryConfigSchema = z.object({
+  config_sources: z.boolean().optional(),
+  project_opencode: z.boolean().optional(),
+  global_opencode: z.boolean().optional(),
+  project_claude: z.boolean().optional(),
+  global_claude: z.boolean().optional(),
+  project_agents: z.boolean().optional(),
+  global_agents: z.boolean().optional(),
+});
+
 export const PermissionsConfigSchema = z.object({
   read: z.record(z.string(), z.string()).optional(),
   edit: z.record(z.string(), z.string()).optional(),
@@ -96,8 +106,8 @@ export const AuthKeysSchema = z.object({
 
 export const OllamaConfigSchema = z.object({
   enabled: z.boolean().default(false),
-  model: z.string().default("qwen3.5:4b"),
-  baseUrl: z.string().default("http://localhost:11434"),
+  model: z.string().default(""),
+  baseUrl: z.string().default(""),
   purpose: z.enum(["verification", "helper", "fallback"]).default("helper"),
 });
 
@@ -130,6 +140,8 @@ const AgentsConfigSchema = z.object({
   zoe: AgentConfigSchema.optional(),
   build: AgentConfigSchema.optional(),
   "pre-plan": AgentConfigSchema.optional(),
+  manager: AgentConfigSchema.optional(),
+  vision: AgentConfigSchema.optional(),
   logician: AgentConfigSchema.optional(),
   librarian: AgentConfigSchema.optional(),
   explore: AgentConfigSchema.optional(),
@@ -162,6 +174,8 @@ const AgentRequirementsConfigSchema = z.object({
   zoe: ModelRequirementSchema.optional(),
   build: ModelRequirementSchema.optional(),
   "pre-plan": ModelRequirementSchema.optional(),
+  manager: ModelRequirementSchema.optional(),
+  vision: ModelRequirementSchema.optional(),
   logician: ModelRequirementSchema.optional(),
   librarian: ModelRequirementSchema.optional(),
   explore: ModelRequirementSchema.optional(),
@@ -185,6 +199,7 @@ export const HiaiOpencodeConfigSchema = z.object({
   lsp: z.record(z.string(), LspServerConfigSchema).optional(),
   subtask2: Subtask2ConfigSchema.optional(),
   skills: SkillsConfigSchema.optional(),
+  skill_discovery: SkillDiscoveryConfigSchema.optional(),
   permissions: PermissionsConfigSchema.optional(),
   auth: AuthKeysSchema.optional(),
   ollama: OllamaConfigSchema.optional(),

package/src/config/schema/agent-overrides.ts

@@ -79,6 +79,8 @@ export const AgentOverridesSchema = z.object({
   general: AgentOverrideConfigSchema.optional(),
   zoe: AgentOverrideConfigSchema.optional(),
   "pre-plan": AgentOverrideConfigSchema.optional(),
+  manager: AgentOverrideConfigSchema.optional(),
+  vision: AgentOverrideConfigSchema.optional(),
   "logician": AgentOverrideConfigSchema.optional(),
   librarian: AgentOverrideConfigSchema.optional(),
   explore: AgentOverrideConfigSchema.optional(),

package/src/config/schema/commands.ts

@@ -9,6 +9,7 @@ export const BuiltinCommandNameSchema = z.enum([
   "start-work",
   "stop-continuation",
   "remove-ai-slops",
+  "mcp-status",
 ])
 
 export type BuiltinCommandName = z.infer<typeof BuiltinCommandNameSchema>

package/src/config/schema/fast-apply.ts

@@ -3,10 +3,10 @@ import { z } from "zod"
 export const FastApplyConfigSchema = z.object({
   /** Enable fast-apply via Ollama (default: false) */
   enabled: z.boolean().optional().default(false),
-  /** Ollama API URL (default: http://localhost:11434) */
-  ollama_url: z.string().optional().default("http://localhost:11434"),
-  /** Model name for fast-apply (default: qwen3.5:9b) */
-  model: z.string().optional().default("qwen3.5:9b"),
+  /** Ollama API URL. Configure in hiai-opencode.json. */
+  ollama_url: z.string().optional().default(""),
+  /** Model name for fast-apply. Configure in hiai-opencode.json. */
+  model: z.string().optional().default(""),
   /** Timeout in milliseconds for Ollama request (default: 30000) */
   timeout: z.number().int().positive().optional().default(30000),
 })

package/src/config/schema/index.ts

@@ -44,6 +44,8 @@ export { BobAgentConfigSchema } from "./bob-agent"
 export type { BobAgentConfig } from "./bob-agent"
 export { SkillsConfigSchema } from "./skills"
 export type { SkillsConfig, SkillDefinition } from "./skills"
+export { SkillDiscoveryConfigSchema } from "./skill-discovery"
+export type { SkillDiscoveryConfig } from "./skill-discovery"
 export { StartWorkConfigSchema } from "./start-work"
 export type { StartWorkConfig } from "./start-work"
 export { TmuxConfigSchema, TmuxLayoutSchema, TmuxIsolationSchema } from "./tmux"

package/src/config/schema/oh-my-opencode-config.ts

@@ -17,6 +17,7 @@ import { ModelCapabilitiesConfigSchema } from "./model-capabilities"
 import { RalphLoopConfigSchema } from "./ralph-loop"
 import { RuntimeFallbackConfigSchema } from "./runtime-fallback"
 import { SkillsConfigSchema } from "./skills"
+import { SkillDiscoveryConfigSchema } from "./skill-discovery"
 import { BobConfigSchema } from "./bob"
 import { BobAgentConfigSchema } from "./bob-agent"
 import { TmuxConfigSchema } from "./tmux"
@@ -30,6 +31,7 @@ const AuthConfigSchema = z.object({
   openrouter: z.string().optional(),
   stitch: z.string().optional(),
   firecrawl: z.string().optional(),
+  context7: z.string().optional(),
 }).optional()
 
 export const HiaiOpenCodeConfigSchema = z.object({
@@ -60,6 +62,7 @@ export const HiaiOpenCodeConfigSchema = z.object({
   experimental: ExperimentalConfigSchema.optional(),
   auto_update: z.boolean().optional(),
   skills: SkillsConfigSchema.optional(),
+  skill_discovery: SkillDiscoveryConfigSchema.optional(),
   ralph_loop: RalphLoopConfigSchema.optional(),
   /**
    * Enable runtime fallback (default: false)

package/src/config/schema/skill-discovery.ts

@@ -0,0 +1,25 @@
+import { z } from "zod"
+
+export const SkillDiscoveryConfigSchema = z.object({
+  /**
+   * Explicit skills.sources entries from hiai-opencode config.
+   * Safe by default because the user intentionally configured them.
+   */
+  config_sources: z.boolean().default(true),
+  /**
+   * Project-local OpenCode skills: .opencode/skills and .opencode/skill.
+   * Kept on by default because they are part of the current project contract.
+   */
+  project_opencode: z.boolean().default(true),
+  /**
+   * Global OpenCode skills from the user's OpenCode config directory.
+   * Off by default to keep clean installs deterministic.
+   */
+  global_opencode: z.boolean().default(false),
+  project_claude: z.boolean().default(false),
+  global_claude: z.boolean().default(false),
+  project_agents: z.boolean().default(false),
+  global_agents: z.boolean().default(false),
+})
+
+export type SkillDiscoveryConfig = z.infer<typeof SkillDiscoveryConfigSchema>