Sunucu

opencode serve komutu, opencode istemcisinin kullanabilecegi bir OpenAPI endpoint’i acan headless bir HTTP sunucusu calistirir.

---

Kullanim

opencode serve [--port <number>] [--hostname <string>] [--cors <origin>]

Secenekler

Flag	Description	Default
--port	Dinlenecek port	4096
--hostname	Dinlenecek host adı	127.0.0.1
--mdns	Enable mDNS discovery	false
--mdns-domain	Custom domain name for mDNS service	opencode.local
--cors	Additional browser origins to allow	[]

--cors birden fazla kez gecilebilir:

opencode serve --cors http://localhost:5173 --cors https://app.example.com

---

Kimlik dogrulama

Sunucuyu HTTP basic auth ile korumak icin OPENCODE_SERVER_PASSWORD ayarlayin. Kullanici adi varsayilan olarak opencode degeridir; degistirmek isterseniz OPENCODE_SERVER_USERNAME ayarlayabilirsiniz. Bu ayar hem opencode serve hem de opencode web icin gecerlidir.

OPENCODE_SERVER_PASSWORD=your-password opencode serve

---

Nasil calisir

opencode calistirdiginizda hem TUI hem de sunucu baslar. TUI, sunucuyla konusan istemci tarafidir. Sunucu bir OpenAPI 3.1 spec endpoint’i acar. Bu endpoint SDK uretiminde de kullanilir.

İpucu

opencode ile programatik etkilesim icin opencode sunucusunu kullanin.

Bu mimari, opencode’un birden fazla istemciyi desteklemesini ve programatik kullanimlari mumkun kilmasini saglar.

opencode serve ile bagimsiz bir sunucu baslatabilirsiniz. opencode TUI aciksa, opencode serve yeni bir sunucu baslatir.

---

Mevcut sunucuya baglanin

TUI baslarken rastgele bir port ve hostname atanir. Bunun yerine --hostname ve --port bayraklarini verebilirsiniz.

/tui endpoint’i sunucu uzerinden TUI’yi surmek icin kullanilabilir. Ornegin bir istemi onceden doldurabilir veya calistirabilirsiniz. Bu kurulum opencode IDE eklentileri tarafindan kullanilir.

---

Spesifikasyon

Sunucu, su adreste gorulebilen bir OpenAPI 3.1 spec yayinlar:

http://<hostname>:<port>/doc

Ornegin http://localhost:4096/doc. Istemci olusturmak, istek/yanit tiplerini incelemek veya Swagger gezgininde acmak icin bu spec’i kullanin.

---

API’ler

opencode sunucusu asagidaki API’leri sunar.

---

Global

Method	Path	Description	Response
GET	/global/health	Get server health and version	{ healthy: true, version: string }
GET	/global/event	Get global events (SSE stream)	Event stream

---

Project

Method	Path	Description	Response
GET	/project	List all projects	Project[]
GET	/project/current	Get the current project	Project

---

Path & VCS

Method	Path	Description	Response
GET	/path	Get the current path	Path
GET	/vcs	Get VCS info for the current project	VcsInfo

---

Instance

Method	Path	Description	Response
POST	/instance/dispose	Dispose the current instance	boolean

---

Config

Method	Path	Description	Response
GET	/config	Get config info	Config
PATCH	/config	Update config	Config
GET	/config/providers	List providers and default models	{ providers: Provider[], default: { [key: string]: string } }

---

Provider

Method	Path	Description	Response
GET	/provider	List all providers	{ all: Provider[], default: {...}, connected: string[] }
GET	/provider/auth	Get provider authentication methods	{ [providerID: string]: ProviderAuthMethod[] }
POST	/provider/{id}/oauth/authorize	Authorize a provider using OAuth	ProviderAuthAuthorization
POST	/provider/{id}/oauth/callback	Handle OAuth callback for a provider	boolean

---

Sessions

Method	Path	Description	Notes
GET	/session	List all sessions	Returns Session[]
POST	/session	Create a new session	body: { parentID?, title? }, returns Session
GET	/session/status	Get session status for all sessions	Returns { [sessionID: string]: SessionStatus }
GET	/session/:id	Get session details	Returns Session
DELETE	/session/:id	Delete a session and all its data	Returns boolean
PATCH	/session/:id	Update session properties	body: { title? }, returns Session
GET	/session/:id/children	Get a session’s child sessions	Returns Session[]
GET	/session/:id/todo	Get the todo list for a session	Returns Todo[]
POST	/session/:id/init	Analyze app and create AGENTS.md	body: { messageID, providerID, modelID }, returns boolean
POST	/session/:id/fork	Fork an existing session at a message	body: { messageID? }, returns Session
POST	/session/:id/abort	Abort a running session	Returns boolean
POST	/session/:id/share	Share a session	Returns Session
DELETE	/session/:id/share	Unshare a session	Returns Session
GET	/session/:id/diff	Get the diff for this session	query: messageID?, returns FileDiff[]
POST	/session/:id/summarize	Summarize the session	body: { providerID, modelID }, returns boolean
POST	/session/:id/revert	Revert a message	body: { messageID, partID? }, returns boolean
POST	/session/:id/unrevert	Restore all reverted messages	Returns boolean
POST	/session/:id/permissions/:permissionID	Respond to a permission request	body: { response, remember? }, returns boolean

---

Messages

Method	Path	Description	Notes
GET	/session/:id/message	List messages in a session	query: limit?, returns { info: Message, parts: Part[]}[]
POST	/session/:id/message	Send a message and wait for response	body: { messageID?, model?, agent?, noReply?, system?, tools?, parts }, returns { info: Message, parts: Part[]}
GET	/session/:id/message/:messageID	Get message details	Returns { info: Message, parts: Part[]}
POST	/session/:id/prompt_async	Send a message asynchronously (no wait)	body: same as /session/:id/message, returns 204 No Content
POST	/session/:id/command	Execute a slash command	body: { messageID?, agent?, model?, command, arguments }, returns { info: Message, parts: Part[]}
POST	/session/:id/shell	Run a shell command	body: { agent, model?, command }, returns { info: Message, parts: Part[]}

---

Commands

Method	Path	Description	Response
GET	/command	List all commands	Command[]

---

Files

Method	Path	Description	Response
GET	/find?pattern=<pat>	Search for text in files	Array of match objects with path, lines, line_number, absolute_offset, submatches
GET	/find/file?query=<q>	Find files and directories by name	string[] (paths)
GET	/find/symbol?query=<q>	Find workspace symbols	Symbol[]
GET	/file?path=<path>	List files and directories	FileNode[]
GET	/file/content?path=<p>	Read a file	FileContent
GET	/file/status	Get status for tracked files	File[]

/find/file query parametreleri

• query (required) - arama metni (fuzzy match)
• type (optional) - sonuclari "file" veya "directory" ile sinirlama
• directory (optional) - arama icin proje kokunu gecersiz kilma
• limit (optional) - en fazla sonuc (1-200)
• dirs (optional) - eski bayrak ("false" sadece dosyalari dondurur)

---

Tools (Deneysel)

Method	Path	Description	Response
GET	/experimental/tool/ids	List all tool IDs	ToolIDs
GET	/experimental/tool?provider=<p>&model=<m>	List tools with JSON schemas for a model	ToolList

---

LSP, Formatters & MCP

Method	Path	Description	Response
GET	/lsp	Get LSP server status	LSPStatus[]
GET	/formatter	Get formatter status	FormatterStatus[]
GET	/mcp	Get MCP server status	{ [name: string]: MCPStatus }
POST	/mcp	Add MCP server dynamically	body: { name, config }, returns MCP status object

---

Agents

Method	Path	Description	Response
GET	/agent	List all available agents	Agent[]

---

Logging

Method	Path	Description	Response
POST	/log	Write log entry. Body: { service, level, message, extra? }	boolean

---

TUI

Method	Path	Description	Response
POST	/tui/append-prompt	Append text to the prompt	boolean
POST	/tui/open-help	Open the help dialog	boolean
POST	/tui/open-sessions	Open the session selector	boolean
POST	/tui/open-themes	Open the theme selector	boolean
POST	/tui/open-models	Open the model selector	boolean
POST	/tui/submit-prompt	Submit the current prompt	boolean
POST	/tui/clear-prompt	Clear the prompt	boolean
POST	/tui/execute-command	Execute a command ({ command })	boolean
POST	/tui/show-toast	Show toast ({ title?, message, variant })	boolean
GET	/tui/control/next	Wait for the next control request	Control request object
POST	/tui/control/response	Respond to a control request ({ body })	boolean

---

Auth

Method	Path	Description	Response
PUT	/auth/:id	Set authentication credentials. Body must match provider schema	boolean

---

Events

Method	Path	Description	Response
GET	/event	Server-sent events stream. First event is server.connected, then bus events	Server-sent events stream

---

Docs

Method	Path	Description	Response
GET	/doc	OpenAPI 3.1 specification	HTML page with OpenAPI spec