diff --git a/packages/app/AGENTS.md b/packages/app/AGENTS.md
index ca19456fec6..9c3bb1b4b66 100644
--- a/packages/app/AGENTS.md
+++ b/packages/app/AGENTS.md
@@ -1,9 +1,10 @@
 ## Debugging
 
-- To test the opencode app, use the playwrite mcp server, the app is already
+- To test the opencode app, use the playwright MCP server, the app is already
   running at http://localhost:3000
 - NEVER try to restart the app, or the server process, EVER.
 
+
 ## SolidJS
 
 - Always prefer `createStore` over multiple `createSignal` calls
diff --git a/packages/opencode/AGENTS.md b/packages/opencode/AGENTS.md
index 287cbc26580..a68fd7f3e32 100644
--- a/packages/opencode/AGENTS.md
+++ b/packages/opencode/AGENTS.md
@@ -3,7 +3,7 @@
 ## Build/Test Commands
 
 - **Install**: `bun install`
-- **Run**: `bun run index.ts`
+- **Run**: `bun run --conditions=browser ./src/index.ts`
 - **Typecheck**: `bun run typecheck` (npm run typecheck)
 - **Test**: `bun test` (runs all tests)
 - **Single test**: `bun test test/tool/tool.test.ts` (specific test file)
@@ -24,4 +24,4 @@
 - **Validation**: All inputs validated with Zod schemas
 - **Logging**: Use `Log.create({ service: "name" })` pattern
 - **Storage**: Use `Storage` namespace for persistence
-- **API Client**: Go TUI communicates with TypeScript server via stainless SDK. When adding/modifying server endpoints in `packages/opencode/src/server/server.ts`, ask the user to generate a new client SDK to proceed with client-side changes.
+- **API Client**: The TypeScript TUI (built with SolidJS + OpenTUI) communicates with the OpenCode server using `@opencode-ai/sdk`. When adding/modifying server endpoints in `packages/opencode/src/server/server.ts`, run `./script/generate.ts` to regenerate the SDK and related files.