DashboardopencodeOpenCode local configuration and develo…

OpenCode local configuration and development gotchas

Category: gotcha
Confidence: 1.00
ID: 01a0b36b-bf68-7137-b303-e7983cec1301
Project ID: c0425955-02bc-4c17-9af2-b114c00077e7
Cross-project: No
Recalled in other projects: 0
Source session: 0OJYWmHUobcuQ4y8f
Created: 2026-09-08 01:17:22
Updated: 2026-09-18 07:29:38

Content

Config-time changes such as opencode.json require a user-controlled quit/restart: file watchers and tool.reload() replay active transforms but do not rerun plugin setup. Never restart production services automatically. Distinguish shekohex/opencode-pty, the removable agent plugin, from anomalyco/opencode-pty’s native daemon imported as @opencode-ai/pty, which persistent PTY support requires. For local UI work, opencode dev web is only a proxy to https://app.opencode.ai; run bun dev serve --port 4096 at the repository root and bun dev -- --port 4444 in packages/app, then open http://localhost:4444.

Move to: