AGENTS.md

1## Priorities
2 
3- Prioritise, in this order: stability, simplicity, performance.
4- Before changing session or timeline code, record a production benchmark baseline and compare it after the change.
5 
6## Debugging
7 
8- NEVER try to restart the app, or the server process, EVER.
9 
10## Local Dev
11 
12- `opencode dev web` proxies `https://app.opencode.ai`, so local UI/CSS changes will not show there.
13- For local UI changes, run the backend and app dev servers separately.
14- Backend (from `packages/opencode`): `bun run --conditions=browser ./src/index.ts serve --port 4096`
15- App (from `packages/app`): `bun dev -- --port 4444`
16- Open `http://localhost:4444` to verify UI changes (it targets the backend at `http://localhost:4096`).
17 
18## SolidJS
19 
20- Always prefer `createStore` over multiple `createSignal` calls
21 
22## Tool Calling
23 
24- ALWAYS USE PARALLEL TOOLS WHEN APPLICABLE.
25 
26## Browser Automation
27 
28Use `agent-browser` for web automation. Run `agent-browser --help` for all commands.
29 
30Core workflow:
31 
321. `agent-browser open <url>` - Navigate to page
332. `agent-browser snapshot -i` - Get interactive elements with refs (@e1, @e2)
343. `agent-browser click @e1` / `fill @e2 "text"` - Interact using refs
354. Re-snapshot after page changes
36