@hiai-gg/hiai-opencode 0.1.9 → 0.2.1

package/README.md

@@ -1,14 +1,16 @@
 # hiai-opencode
 
 [![CI](https://github.com/HiAi-gg/hiai-opencode/actions/workflows/ci.yml/badge.svg?branch=main&event=push)](https://github.com/HiAi-gg/hiai-opencode/actions/workflows/ci.yml?query=branch%3Amain)
+[![npm](https://img.shields.io/npm/v/@hiai-gg/hiai-opencode?style=flat-square&logo=npm)](https://www.npmjs.com/package/@hiai-gg/hiai-opencode)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE.md)
 
 `hiai-opencode` is an OpenCode plugin that turns vanilla OpenCode into an opinionated multi-agent cockpit.
 
 **What you get on top of plain OpenCode:**
 
-- **12-agent canonical model** with peer-aware prompts — Bob orchestrates, Coder/Sub implement, Strategist plans, Critic gates, Researcher discovers via Context7/Firecrawl/grep_app/RAG/MemPalace, Designer drives Stitch UI generation, Brainstormer owns copy/SEO, Vision extracts PDFs/images, Manager keeps memory, Quality Guardian reviews, Guard sandboxes bash.
-- **Mode → agent routing** for `task()` delegation — `quick`/`bounded`/`unspecified-low` → Sub, `deep`/`cross-module` → Coder, `ultrabrain` → Strategist, `visual-engineering`/`artistry` → Designer, `writing` → Brainstormer, `git-ops` → Manager. No more "everything routes to coder".
-- **MCP wiring out of the box** — Stitch, Firecrawl, Context7, grep_app, websearch, RAG, MemPalace, Sequential-Thinking, Playwright. Each agent's prompt knows which MCP servers it owns.
+- **14-agent canonical model (9 visible + 5 hidden)** with peer-aware prompts — Bob orchestrates, Coder/Sub implement, Strategist plans, Critic gates, Researcher discovers via Context7/Firecrawl/grep_app/MemPalace, Designer drives Stitch UI generation, Writer owns copy/SEO, Vision extracts PDFs/images, Manager keeps memory, Quality Guardian reviews, Sandbox sandboxes bash.
+- **Mode → agent routing** for `task()` delegation — `quick`/`bounded`/`unspecified-low` → Sub, `deep`/`cross-module` → Coder, `ultrabrain` → Strategist, `visual-engineering`/`artistry` → Designer, `writing` → Writer, `git-ops` → Manager. No more "everything routes to coder".
+- **MCP wiring out of the box** — Stitch, Firecrawl, Context7, grep_app, MemPalace, Sequential-Thinking. Each agent's prompt knows which MCP servers it owns.
 - **LSP defaults** for TypeScript, Svelte, ESLint, Bash, Pyright. Coder must run `lsp_diagnostics` after every edit.
 - **Permission discipline** — read-only agents cannot delegate; write-capable agents have explicit file-scope limits.
 
@@ -39,21 +41,30 @@ Then run `hiai-opencode doctor`, `hiai-opencode mcp-status`, and `opencode debug
 
 For the full operator playbook, see [AGENTS.md](AGENTS.md). 🤖
 
+
 ## Agents
 
+**9 Visible Primary Agents:**
+
 | Agent | Role | When to use |
 |-------|------|-------------|
 | `Bob` | Orchestrator, router, distributor | Entry point; complex tasks needing multi-agent coordination |
 | `Coder` | Deep implementation, focused execution | Complex features, refactors, deep work |
-| `Sub` | Bounded cheap executor | Small targeted changes, quick fixes |
 | `Strategist` | Planning, architecture, pre-check | Scope definition, architectural decisions |
-| `Guard` | Final acceptor, workflow enforcer | Closure validation, output acceptance |
+| `Manager` | Delegation orchestrator, TODO tracker | Coordinates specialists, maintains session continuity |
 | `Critic` | Review gate, high-accuracy verification | Plan review, code review, regression catch |
+| `Designer` | UI/visual direction via Stitch MCP | Visual problems, design systems, screen generation |
 | `Researcher` | Local + external search | Codebase exploration, documentation discovery |
-| `Designer` | UI/visual, creative direction | Visual problems, UX decisions, branding |
-| `Brainstormer` | Ideation, content, copy | Landing pages, CTA, feature copy, onboarding |
-| `Vision` | Image/PDF/layout analysis | Visual inspection, multimodal interpretation |
-| `Manager` | Memory, bootstrap, ledger | Durable state, session continuity, project init |
+| `Writer` | Content, copy, positioning, SEO | Website copy, product messaging, naming |
+| `Vision` | PDF/image/diagram extraction, browser UI verification | Multimodal analysis, live browser verification |
+
+**5 Hidden System Agents** (used internally, not for direct selection):
+
+- `Agent Skills` — Skill registry, discovery, and capability orchestration
+- `Sub` — Compatibility wrapper for bounded execution (folded into Coder's contour)
+- `build` — Default executor (OpenCode system agent)
+- `plan` — Plan mode agent (OpenCode system agent)
+- `Quality Guardian` — Post-implementation review and bug investigation (compatibility alias for Critic)
 
 ## Modes (Task Routing)
 
@@ -61,16 +72,16 @@ Mode determines prompt append, variant, and reasoning effort. The executor agent
 
 | Mode | Agent | Prompt variant | When to use |
 |------|-------|----------------|-------------|
-| `quick` | `sub` | Fast bounded | Small targeted changes |
-| `writing` | `brainstormer` | Docs/prose | Content, i18n, copy |
+| `quick` | `coder` (via fast bounded contour) | Fast bounded | Small targeted changes |
+| `writing` | `writer` | Docs/prose | Content, i18n, copy |
 | `deep` | `coder` | Deep reasoning | Complex implementation |
 | `ultrabrain` | `strategist` | Plan-only | Architecture, hard logic |
 | `visual-engineering` | `designer` | UI/visual | Visual problems |
 | `artistry` | `designer` | Creative | Brand, SEO, creative |
 | `git` | `platform-manager` | Git ops | Version control operations |
-| `bounded` | `sub` | Mid-tier bounded | Moderate effort changes |
+| `bounded` | `coder` (via fast bounded contour) | Mid-tier bounded | Moderate effort changes |
 | `cross-module` | `coder` | Deep substantial | Multi-component changes |
-| `unspecified-low` | `sub` | Bounded | Unclassified small tasks |
+| `unspecified-low` | `coder` (via fast bounded contour) | Bounded | Unclassified small tasks |
 | `unspecified-high` | `coder` | Deep | Unclassified substantial tasks |
 
 ## Integrations
@@ -80,22 +91,18 @@ MCP integrations and which agents use them:
 | Service | Key env var | Agent(s) | What it's for |
 |---------|------------|----------|---------------|
 | Stitch | `STITCH_AI_API_KEY` | Designer | UI generation, design systems, screen variants |
-| Firecrawl | `FIRECRAWL_API_KEY` | Researcher | Web scraping, crawl, extract, search |
+| Firecrawl | `FIRECRAWL_API_KEY` | Researcher | CLI skill (not MCP) for web scraping, crawl, extract, search |
 | Context7 | `CONTEXT7_API_KEY` | Researcher, Coder | Library API documentation |
 | grep_app | — | Researcher | GitHub OSS code pattern search |
-| websearch (Exa) | `EXA_API_KEY` | Researcher | General web search |
-| websearch (Tavily) | `TAVILY_API_KEY` | Researcher | General web search (alt provider) |
-| RAG | `OPENCODE_RAG_URL` | Researcher, Brainstormer, Manager | Project knowledge base |
-| MemPalace | — | Manager (primary), all agents | Project memory and past decisions |
+| MemPalace | MEMPALACE_PYTHON (optional) | Manager (primary), all agents | Project memory and past decisions |
 | Sequential-Thinking | — | Strategist, Critic | Deep reasoning for planning/review |
-| Playwright | — | Coder | Browser tests and automation |
 
 ## What You Get
 
-- **10 visible primary agents** + **4 hidden system agents** (Agent Skills, Sub, build, plan)
+- **9 visible primary agents** + **5 hidden system agents** (Agent Skills, Sub, build, plan, Quality Guardian)
 - **Mode-based task routing** via `task(category=..., ...)` or `task(mode=..., ...)`
 - Skill materialization into OpenCode's `skills/` view
-- MCP wiring for `playwright`, `stitch`, `sequential-thinking`, `firecrawl`, `rag`, `mempalace`, `context7`, plus remote `websearch` and `grep_app`
+- MCP wiring for `stitch`, `sequential-thinking`, `firecrawl-cli`, `mempalace`, `context7`, and `grep_app`
 - LSP wiring for TypeScript, Svelte, Python, Bash, and ESLint
 
 ## Continuation, Ralph-Loop, And Auto-Start
@@ -138,10 +145,7 @@ Optional, depending on which services you want:
 - `FIRECRAWL_API_KEY` for Firecrawl
 - `STITCH_AI_API_KEY` for Stitch
 - `CONTEXT7_API_KEY` for Context7
-- `EXA_API_KEY` for higher Exa websearch limits
-- `TAVILY_API_KEY` when `mcp.websearch.provider` is `tavily`
 - Python 3.9+ or `uv` for MemPalace
-- a running RAG endpoint if you enable `rag`
 - local language servers if you want LSP beyond the npm-bootstrapped helpers
 
 ## Install
@@ -158,14 +162,15 @@ Optional Dynamic Context Pruning plugin:
 opencode plugin @tarquinen/opencode-dcp@latest --global
 ```
 
-Do not put MCP server packages such as `firecrawl-mcp`, `@playwright/mcp`, or `@modelcontextprotocol/server-sequential-thinking` into the OpenCode `plugin` array. They are MCP servers, not OpenCode plugins. `hiai-opencode` only provides the OpenCode-side launch wiring for them through its `mcp` config and helper launchers.
+Do not put MCP server packages such as `@modelcontextprotocol/server-sequential-thinking` into the OpenCode `plugin` array. They are MCP servers, not OpenCode plugins. Install the CLI skill separately using `opencode plugin` or `npm install -g @mendableai/firecrawl`.
 
 Manual OpenCode config equivalent:
 
 ```json
 {
   "$schema": "https://opencode.ai/config.json",
-  "plugin": ["@hiai-gg/hiai-opencode"]
+  "plugin": ["@hiai-gg/hiai-opencode",
+    "@tarquinen/opencode-dcp@latest"]
 }
 ```
 
@@ -194,23 +199,19 @@ If you installed only from npm/OpenCode and do not have this repository checked
 ```json
 {
   "models": {
-    "bob": { "model": "openrouter/moonshotai/kimi-k2.6", "recommended": "xhigh" },
-    "coder": { "model": "openrouter/minimax/minimax-m2.7", "recommended": "high" },
-    "strategist": { "model": "openrouter/anthropic/claude-opus-latest", "recommended": "high" },
-    "guard": { "model": "openrouter/qwen/qwen3.6-plus", "recommended": "middle" },
-    "critic": { "model": "openrouter/xiaomi/mimo-v2.5-pro", "recommended": "high" },
+    "bob": { "model": "kimi-for-coding/k2p6", "recommended": "xhigh" },
+    "coder": { "model": "minimax-coding-plan/MiniMax-M2.7", "recommended": "high" },
+    "strategist": { "model": "deepseek/deepseek-v4-pro", "recommended": "high" },
+    "manager": { "model": "opencode-go/qwen3.6-plus", "recommended": "middle" },
+    "critic": { "model": "opencode-go/mimo-v2.5-pro", "recommended": "high" },
     "designer": { "model": "openrouter/google/gemini-3.1-pro-preview", "recommended": "design" },
     "researcher": { "model": "openrouter/deepseek/deepseek-v4-flash", "recommended": "fast" },
-    "manager": { "model": "openrouter/qwen/qwen3.5-9b", "recommended": "fast" },
-    "brainstormer": { "model": "openrouter/mistralai/mistral-small-2603", "recommended": "writing" },
+    "writer": { "model": "openrouter/mistralai/mistral-small-2603", "recommended": "writing" },
     "vision": { "model": "openrouter/google/gemma-4-26b-a4b-it", "recommended": "vision" }
   },
   "mcp": {
-    "playwright": { "enabled": true },
     "sequential-thinking": { "enabled": true },
-    "firecrawl": { "enabled": true },
     "mempalace": { "enabled": true, "pythonPath": "{env:MEMPALACE_PYTHON:-./.venv/bin/python}" },
-    "rag": { "enabled": false },
     "stitch": { "enabled": false },
     "context7": { "enabled": true }
   }
@@ -236,9 +237,6 @@ Use the exact model IDs printed by OpenCode in `hiai-opencode.json`. For example
 export FIRECRAWL_API_KEY=...
 export STITCH_AI_API_KEY=...
 export CONTEXT7_API_KEY=...
-export EXA_API_KEY=...
-# or, if mcp.websearch.provider is "tavily":
-export TAVILY_API_KEY=...
 ```
 
 See [Environment Variables And Keys](#environment-variables-and-keys) for the full list.
@@ -249,12 +247,12 @@ See [Environment Variables And Keys](#environment-variables-and-keys) for the fu
 opencode
 hiai-opencode doctor
 hiai-opencode mcp-status
-hiai-opencode export-mcp .mcp.json
+hiai-opencode export-mcp .opencode/.mcp.json
 opencode debug config
 opencode mcp list --print-logs --log-level INFO
 ```
 
-`opencode mcp list` reads static `.mcp.json` files in many OpenCode versions. Runtime MCP servers launched by plugins may work but not appear there. If you want `opencode mcp list` visibility, run `hiai-opencode export-mcp .mcp.json` first.
+`opencode mcp list` reads static `.mcp.json` files in many OpenCode versions. Runtime MCP servers launched by plugins may work but not appear there. If you want `opencode mcp list` visibility, run `hiai-opencode export-mcp .opencode/.mcp.json` first.
 
 `hiai-opencode mcp-status` is the fastest visibility check. It does not change OpenCode config; it reports config location, enabled MCP services, missing keys, and basic local runtime availability.
 
@@ -265,7 +263,7 @@ opencode mcp list --print-logs --log-level INFO
 Direct npm install is only needed for development or inspection:
 
 ```bash
-npm install @hiai-gg/hiai-opencode
+bun install
 ```
 
 Local development:
@@ -293,11 +291,9 @@ Find or create hiai-opencode.json in the project root or .opencode/. Use its mcp
 Keep skill discovery deterministic unless I explicitly ask for external skills. Leave global_opencode, project_claude, global_claude, project_agents, and global_agents disabled by default.
 
 Enable only services that can run on this machine:
-- playwright: requires node/npx; optionally set HIAI_PLAYWRIGHT_INSTALL_BROWSERS=1 before first run if browser binaries are needed.
 - sequential-thinking: requires node/npx.
-- firecrawl: requires FIRECRAWL_API_KEY.
+- firecrawl-cli: uses CLI skill at `skills/firecrawl-cli/` and requires `FIRECRAWL_API_KEY` for web scraping and extraction tasks.
 - mempalace: requires uv or Python 3.9+ with pip; set `mcp.mempalace.pythonPath` (or `MEMPALACE_PYTHON`) if needed. Leave `HIAI_MCP_AUTO_INSTALL` enabled unless the user forbids package installation.
-- rag: requires OPENCODE_RAG_URL or a running local endpoint at http://localhost:9002/tools/search.
 - stitch: requires STITCH_AI_API_KEY.
 - context7: works without a key but use CONTEXT7_API_KEY if available.
 
@@ -306,7 +302,7 @@ Check .env.example, report missing keys without printing secret values, and neve
 Run verification commands where available:
 - opencode debug config
 - hiai-opencode mcp-status
-- hiai-opencode export-mcp .mcp.json
+- hiai-opencode export-mcp .opencode/.mcp.json
 - opencode mcp list --print-logs --log-level INFO
 
 If a dependency is missing, install only user-level or project-local dependencies, explain every command before running it, and do not use sudo/admin rights unless the user explicitly asks.
@@ -341,12 +337,12 @@ Important prompt entrypoints:
 - `Bob`: [src/agents/bob.ts](src/agents/bob.ts) and `src/agents/bob/*`
 - `Coder`: `src/agents/coder/*`
 - `Strategist`: `src/agents/strategist/*`
-- `Guard`: `src/agents/guard/*`
+- `Manager`: `src/agents/manager/*`
 - `Critic`: `src/agents/critic/*`
 - `Vision`: [src/agents/ui.ts](src/agents/ui.ts)
 - `Manager`: [src/agents/platform-manager.ts](src/agents/platform-manager.ts)
 - `Researcher`: [src/agents/researcher.ts](src/agents/researcher.ts)
-- `Brainstormer` / `Writer`: [src/agents/brainstormer.ts](src/agents/brainstormer.ts)
+- `Writer` / `Writer`: [src/agents/writer.ts](src/agents/writer.ts)
 
 Name mapping and visibility:
 
@@ -368,16 +364,15 @@ Built-in helper skills include browser automation, frontend UI/UX, review, git w
 Website/product copy should use:
 
 ```text
-task(subagent_type="brainstormer", load_skills=["website-copywriting"], ...)
+task(subagent_type="writer", load_skills=["website-copywriting"], ...)
 ```
 
-`writer`, `copywriter`, and `content-writer` are aliases for `brainstormer`.
+`writer`, `copywriter`, and `content-writer` are aliases for `writer`.
 
 Manager memory stewardship:
 
 - Use `task(subagent_type="platform-manager", ...)` or `task(subagent_type="manager", ...)` for MemPalace cleanup, session ledgers, TODO hygiene, and architecture decision handoff.
 - Manager writes only durable decisions and important project state. It should not dump raw chat logs into memory.
-- RAG is retrieval-first by default; Manager syncs architecture summaries to RAG only when the configured endpoint exposes write/upsert capability.
 
 Skill discovery defaults:
 
@@ -427,14 +422,11 @@ Important service variables:
 - `STITCH_AI_API_KEY`
 - `FIRECRAWL_API_KEY`
 - `CONTEXT7_API_KEY`
-- `EXA_API_KEY`
-- `TAVILY_API_KEY`
 - `OLLAMA_BASE_URL`
 - `OLLAMA_MODEL`
 - `MEMPALACE_PYTHON`
 - `MEMPALACE_PALACE_PATH`
-- `OPENCODE_RAG_URL`
-- `HIAI_PLAYWRIGHT_INSTALL_BROWSERS`
+
 - `HIAI_MCP_AUTO_INSTALL`
 - `HIAI_OPENCODE_AUTO_EXPORT_MCP`
 - `HIAI_OPENCODE_MCP_EXPORT_PATH`
@@ -450,9 +442,7 @@ The user-facing MCP switchboard is the `mcp` object in `hiai-opencode.json`:
 ```json
 {
   "mcp": {
-    "playwright": { "enabled": true },
     "mempalace": { "enabled": false },
-    "websearch": { "enabled": true, "provider": "exa" },
     "grep_app": { "enabled": true }
   }
 }
@@ -464,48 +454,42 @@ The source of truth for default MCP wiring is `src/mcp/registry.ts`. Change that
 
 - `stitch`
 - `context7`
-- `websearch`: defaults to Exa remote MCP. `EXA_API_KEY` is optional for Exa; set `"provider": "tavily"` and `TAVILY_API_KEY` to use Tavily.
 - `grep_app`
 
 ### Works with local helper bootstrap
 
-- `playwright`: launches `@playwright/mcp@latest` through the helper npm runner. Set `HIAI_PLAYWRIGHT_INSTALL_BROWSERS=1` if you want the launcher to install Chromium on first start.
 - `sequential-thinking`: launches `@modelcontextprotocol/server-sequential-thinking` through the helper npm runner.
-- `firecrawl`: launches `firecrawl-mcp` through the helper npm runner and requires `FIRECRAWL_API_KEY`.
-
-### Playwright On Minimal Linux Hosts
+- `firecrawl`: uses the CLI skill at `skills/firecrawl-cli/` and requires `FIRECRAWL_API_KEY` for web scraping and extraction tasks.
 
-`hiai-opencode mcp-status` can confirm that the Playwright MCP launcher is available, but it cannot guarantee that Chromium can start on a minimal Linux image.
+### Browser Automation
 
-Playwright has two dependency layers:
+For browser automation, use the `/agent-browser` skill instead of an MCP server. The CLI uses native Chrome via CDP — no Playwright.
 
-- Browser binary: install with `HIAI_PLAYWRIGHT_INSTALL_BROWSERS=1` before OpenCode starts, or run `npx playwright install chromium`.
-- System libraries: if Chromium errors with missing packages like `libnspr4`, `libnss3`, `libatk-bridge`, or `libgtk-3`, install them with admin rights, usually `sudo npx playwright install-deps chromium`.
+**Install** (Bun):
+```bash
+bun add -g agent-browser && agent-browser install
+```
 
-If sudo is not available:
+Or via npm:
+```bash
+npm i -g agent-browser && agent-browser install
+```
 
-- Use an already installed system browser by editing the Playwright command in `.opencode/hiai-opencode.json`, for example:
+Repo: https://github.com/vercel-labs/agent-browser
 
-```json
-{
-  "mcp": {
-    "playwright": {
-      "enabled": true,
-      "command": ["node", "{pluginRoot}/assets/mcp/playwright.mjs", "--browser", "chrome"],
-      "timeout": 600000
-    }
-  }
-}
-```
+Key environment variables (`AGENT_BROWSER_*`):
+- `AGENT_BROWSER_HEADED=1` — show browser window
+- `AGENT_BROWSER_SESSION=name` — isolated session
+- `AGENT_BROWSER_PROFILE=path` — persistent profile
+- `AGENT_BROWSER_PROVIDER=name` — cloud provider (browserbase, browseruse, kernel)
+- `AGENT_BROWSER_AUTO_CONNECT=1` — auto-discover running Chrome
+- `AGENT_BROWSER_EXECUTABLE_PATH` — custom browser binary
 
-- Try `--browser msedge` if Edge is installed.
-- Use a remote/CDP browser or the `agent-browser`/`playwright-cli` skill path if those tools are installed.
-- Use `curl` only as a degraded HTTP check. It does not replace browser interaction, screenshots, auth flows, or client-side app verification.
+Use `/agent-browser` skill in OpenCode for browser tasks — navigation, snapshots, screenshots, form filling, console/network inspection.
 
 ### Needs upstream runtime or extra setup
 
 - `mempalace`: prefers `uv`; otherwise uses Python. You can force interpreter selection via `mcp.mempalace.pythonPath` or `MEMPALACE_PYTHON`. If `HIAI_MCP_AUTO_INSTALL` is not `0`, `false`, or `no`, the launcher can run `python -m pip install --user mempalace` on first start.
-- `rag`: requires your own running endpoint
 
 ### Important Windows note
 
@@ -518,47 +502,6 @@ This most often affects `sequential-thinking` and `mempalace`, and sometimes loc
 
 ## Troubleshooting MCP Servers
 
-### Firecrawl tools return "FIRECRAWL_API_KEY missing"
-
-The `skill_mcp` env scrubber filters `process.env` before launching stdio MCP servers — secret-shaped names (`*_API_KEY`, `*_TOKEN`, etc.) and npm/pnpm config vars are stripped so they cannot leak into a malicious server. Keys you set via `hiai-opencode.json` are an explicit allowlist and pass through.
-
-If your key only lives in `process.env`, move it into the MCP `environment` block:
-
-```json
-{
-  "mcp": {
-    "firecrawl": {
-      "enabled": true,
-      "environment": { "FIRECRAWL_API_KEY": "fc-..." }
-    }
-  }
-}
-```
-
-(Versions ≤ 0.1.8 had a bug where customEnv was merged before filtering, so even an explicit `FIRECRAWL_API_KEY` got stripped. Fixed in 0.1.9 — explicit `environment` always wins over the filter.)
-
-### Playwright MCP fails to find Chromium
-
-When `@playwright/mcp` cannot locate a system browser, point it at one explicitly:
-
-```json
-{
-  "mcp": {
-    "playwright": {
-      "enabled": true,
-      "environment": {
-        "PLAYWRIGHT_MCP_EXECUTABLE_PATH": "/usr/bin/chromium"
-      }
-    }
-  }
-}
-```
-
-The path can be Chromium, Chrome, or Edge. Run `npx playwright install chromium` first if no browser is installed.
-
-### `skill_mcp(playwright)` connects to localhost:3001 and fails
-
-If `mcp__playwright__browser_*` works but `skill_mcp(mcp_name="playwright", ...)` errors with a connection to `localhost:3001/mcp`, you have a leftover HTTP-mode MCP registration in your global or parent `opencode.json`. Either start the HTTP server, or remove that registration so the plugin's stdio registration (`npx @playwright/mcp@latest`) is the only one. As a workaround, agents (Vision, Critic) can call `mcp__playwright__browser_*` direct tools instead of going through `skill_mcp`.
 
 ## Diagnostics
 
@@ -572,17 +515,17 @@ Available CLI:
 ```bash
 hiai-opencode doctor
 hiai-opencode mcp-status
-hiai-opencode export-mcp .mcp.json
+hiai-opencode export-mcp .opencode/.mcp.json
 ```
 
-By default, the plugin auto-exports `.mcp.json` at workspace startup when the file is missing. This closes the visibility gap where runtime plugin MCP works but `opencode mcp list` only reads static files. Control it with:
+By default, the plugin auto-exports `.opencode/.mcp.json` at workspace startup when the file is missing. This closes the visibility gap where runtime plugin MCP works but `opencode mcp list` only reads static files. Control it with:
 
 ```bash
 export HIAI_OPENCODE_AUTO_EXPORT_MCP=if-missing  # default
 export HIAI_OPENCODE_AUTO_EXPORT_MCP=always      # overwrite only managed hiai-opencode exports
 export HIAI_OPENCODE_AUTO_EXPORT_MCP=force       # force overwrite even non-managed files
 export HIAI_OPENCODE_AUTO_EXPORT_MCP=0           # disable auto-export
-export HIAI_OPENCODE_MCP_EXPORT_PATH=.mcp.json   # override path
+export HIAI_OPENCODE_MCP_EXPORT_PATH=.opencode/.mcp.json   # override path
 export HIAI_OPENCODE_EXPORT_MCP_MODE=safe        # export-mcp command mode: safe|force
 ```
 
@@ -593,24 +536,13 @@ Inside OpenCode, use the slash command:
 /mcp-status
 ```
 
-Example output:
-
-```text
-MCP Servers:
-✅ playwright           - backend ok
-⚠️  rag                 - enabled, http://localhost:9002/tools/search not reachable
-✅ firecrawl            - backend ok
-❌ mempalace            - python not found
-⚠️  stitch              - enabled, API key missing (STITCH_AI_API_KEY)
-```
-
 `hiai-opencode export-mcp` writes a standard `.mcp.json` so hosts whose `mcp list` ignores plugin runtime MCP can still show the same servers statically. Exports are marker-tagged as hiai-managed; by default, the command avoids overwriting non-managed files unless `HIAI_OPENCODE_EXPORT_MCP_MODE=force` is set.
 
 Use:
 
 ```bash
 hiai-opencode mcp-status
-hiai-opencode export-mcp .mcp.json
+hiai-opencode export-mcp .opencode/.mcp.json
 opencode debug config
 opencode mcp list --print-logs --log-level INFO
 ```
@@ -626,12 +558,13 @@ opencode mcp list --print-logs --log-level INFO
 | Planning / workflow influences | [obra/superpowers](https://github.com/obra/superpowers) | planning, review, and debugging ideas |
 | Specialist / platform influences | [vtemian/micode](https://github.com/vtemian/micode) | platform-style specialist behavior |
 | Agent skill ecosystem | [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills) | tactical workflow skill ideas |
+| Supabase Postgres skill | [supabase/agent-skills](https://github.com/supabase/agent-skills/blob/main/skills/supabase-postgres-best-practices/SKILL.md) | Postgres best practices skill |
+| Browser automation | [vercel-labs/agent-browser](https://github.com/vercel-labs/agent-browser) | CLI-based browser automation via CDP |
 | Optional external plugin | [Opencode-DCP/opencode-dynamic-context-pruning](https://github.com/Opencode-DCP/opencode-dynamic-context-pruning) | installed separately |
 | MemPalace | [MemPalace/mempalace](https://github.com/MemPalace/mempalace) | external MCP/runtime |
-| Playwright MCP | [microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp) | external MCP |
 | Sequential Thinking | [modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers) | external MCP |
-| Firecrawl MCP | [firecrawl-ai/firecrawl-mcp-server](https://github.com/firecrawl-ai/firecrawl-mcp-server) | external MCP |
-| Context7 MCP | [upstash/context7-mcp](https://github.com/upstash/context7-mcp) | external MCP |
+| Firecrawl CLI skill | [firecrawl/firecrawl](https://github.com/firecrawl/firecrawl) | CLI-based web scraping, crawl, extract, search |
+| Context7 MCP | [upstash/context7](https://github.com/upstash/context7) | external MCP |
 | bun-pty / PTY ecosystem | [shekohex/opencode-pty](https://github.com/shekohex/opencode-pty) | PTY/runtime integration influence |
 
 ## Build And Publish
@@ -659,7 +592,7 @@ Before publishing:
 1. run `bun run build`
 2. run `npm pack --dry-run`
 3. verify `debug config`
-4. run `hiai-opencode export-mcp .mcp.json` if you need static `mcp list` visibility
+4. run `hiai-opencode export-mcp .opencode/.mcp.json` if you need static `mcp list` visibility
 
 Publish: