Server

Komanda opencode serve pokrece headless HTTP server koji izlaže OpenAPI endpoint koji opencode klijent moze koristiti.

---

Korištenje

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

Opcije

Zastava	Opis	Default
--port	Port na kojem slusa	4096
--hostname	Hostname na kojem slusa	127.0.0.1
--mdns	Ukljuci mDNS otkrivanje	false
--mdns-domain	Prilagodeni domen za mDNS servis	opencode.local
--cors	Dodatni browser origin-i koje dozv.	[]

--cors mozete navesti vise puta:

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

---

Autentifikacija

Postavite OPENCODE_SERVER_PASSWORD da zastitite server HTTP basic auth mehanizmom. Korisnicko ime je po defaultu opencode, ili postavite OPENCODE_SERVER_USERNAME za nadjacavanje. Ovo vazi i za opencode serve i za opencode web.

OPENCODE_SERVER_PASSWORD=your-password opencode serve

---

Kako radi

Kada pokrenete opencode, pokrecu se TUI i server. TUI je klijent koji komunicira sa serverom. Server izlaže OpenAPI 3.1 spec endpoint koji se koristi i za generisanje SDK-a.

Tip

Koristite opencode server za programsku interakciju sa opencode-om.

Ova arhitektura omogucava opencode podrsku za vise klijenata i programsku interakciju.

Mozete pokrenuti opencode serve da startate standalone server. Ako je opencode TUI vec pokrenut, opencode serve ce pokrenuti novi server.

---

Povezivanje na postojeći server

Kada pokrenete TUI, port i hostname se nasumicno dodijele. Umjesto toga, mozete zadati --hostname i --port zastave, pa se povezati na taj server.

Endpoint /tui mozete koristiti za upravljanje TUI-jem kroz server. Na primjer, mozete unaprijed popuniti ili pokrenuti prompt. Ovaj setup koriste OpenCode IDE pluginovi.

---

Specifikacija

Server objavljuje OpenAPI 3.1 specifikaciju koju mozete vidjeti na:

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

Na primjer, http://localhost:4096/doc. Koristite specifikaciju da generisete klijente ili pregledate tipove zahtjeva i odgovora. Mozete je otvoriti i u Swagger exploreru.

---

API-ji

opencode server izlaže sljedece API-je.

---

Globalno

Metoda	Putanja	Opis	Odgovor
GET	/global/health	Dohvati zdravlje i verziju servera	{ healthy: true, version: string }
GET	/global/event	Dohvati globalne događaje (SSE tok)	Event stream

---

Projekt

Metoda	Putanja	Opis	Odgovor
GET	/project	Izlistaj sve projekte	Project[]
GET	/project/current	Dohvati trenutni projekt	Project

---

Putanja i VCS

Metoda	Putanja	Opis	Odgovor
GET	/path	Dohvati trenutnu putanju	Path
GET	/vcs	Dohvati VCS informacije za trenutni projekt	VcsInfo

---

Instanca

Metoda	Putanja	Opis	Odgovor
POST	/instance/dispose	Ugasi trenutnu instancu	boolean

---

Konfiguracija

Metoda	Putanja	Opis	Odgovor
GET	/config	Dohvati informacije o konfiguraciji	Config
PATCH	/config	Ažuriraj konfiguraciju	Config
GET	/config/providers	Izlistaj provajdere i zadane modele	{ providers: Provider[], default: { [key: string]: string } }

---

Provajder

Metoda	Putanja	Opis	Odgovor
GET	/provider	Izlistaj sve provajdere	{ all: Provider[], default: {...}, connected: string[] }
GET	/provider/auth	Dohvati metode autentifikacije provajdera	{ [providerID: string]: ProviderAuthMethod[] }
POST	/provider/{id}/oauth/authorize	Autoriziraj provajdera koristeći OAuth	ProviderAuthAuthorization
POST	/provider/{id}/oauth/callback	Obradi OAuth povratni poziv za provajdera	boolean

---

Sesije

Metoda	Putanja	Opis	Napomene
GET	/session	Izlistaj sve sesije	Returns Session[]
POST	/session	Kreiraj novu sesiju	body: { parentID?, title? }, returns Session
GET	/session/status	Dohvati status sesije za sve sesije	Returns { [sessionID: string]: SessionStatus }
GET	/session/:id	Dohvati detalje sesije	Returns Session
DELETE	/session/:id	Obriši sesiju i sve njene podatke	Returns boolean
PATCH	/session/:id	Ažuriraj svojstva sesije	body: { title? }, returns Session
GET	/session/:id/children	Dohvati pod-sesije sesije	Returns Session[]
GET	/session/:id/todo	Dohvati listu zadataka za sesiju	Returns Todo[]
POST	/session/:id/init	Analiziraj aplikaciju i kreiraj AGENTS.md	body: { messageID, providerID, modelID }, returns boolean
POST	/session/:id/fork	Granaj postojeću sesiju na poruci	body: { messageID? }, returns Session
POST	/session/:id/abort	Prekini sesiju u toku	Returns boolean
POST	/session/:id/share	Podijeli sesiju	Returns Session
DELETE	/session/:id/share	Prestani dijeliti sesiju	Returns Session
GET	/session/:id/diff	Dohvati razlike za ovu sesiju	query: messageID?, returns FileDiff[]
POST	/session/:id/summarize	Rezimiraj sesiju	body: { providerID, modelID }, returns boolean
POST	/session/:id/revert	Vrati poruku	body: { messageID, partID? }, returns boolean
POST	/session/:id/unrevert	Vrati sve vraćene poruke	Returns boolean
POST	/session/:id/permissions/:permissionID	Odgovori na zahtjev za dozvolu	body: { response, remember? }, returns boolean

---

Poruke

Metoda	Putanja	Opis	Napomene
GET	/session/:id/message	Izlistaj poruke u sesiji	query: limit?, returns { info: Message, parts: Part[]}[]
POST	/session/:id/message	Pošalji poruku i čekaj odgovor	body: { messageID?, model?, agent?, noReply?, system?, tools?, parts }, returns { info: Message, parts: Part[]}
GET	/session/:id/message/:messageID	Dohvati detalje poruke	Returns { info: Message, parts: Part[]}
POST	/session/:id/prompt_async	Pošalji poruku asinkrono (bez čekanja)	body: same as /session/:id/message, returns 204 No Content
POST	/session/:id/command	Izvrši slash naredbu	body: { messageID?, agent?, model?, command, arguments }, returns { info: Message, parts: Part[]}
POST	/session/:id/shell	Pokreni shell naredbu	body: { agent, model?, command }, returns { info: Message, parts: Part[]}

---

Naredbe

Metoda	Putanja	Opis	Odgovor
GET	/command	Izlistaj sve naredbe	Command[]

---

Datoteke

Metoda	Putanja	Opis	Odgovor
GET	/find?pattern=<pat>	Traži tekst u datotekama	Array of match objects with path, lines, line_number, absolute_offset, submatches
GET	/find/file?query=<q>	Pronađi datoteke i direktorije po imenu	string[] (paths)
GET	/find/symbol?query=<q>	Pronađi simbole radnog prostora	Symbol[]
GET	/file?path=<path>	Izlistaj datoteke i direktorije	FileNode[]
GET	/file/content?path=<p>	Pročitaj datoteku	FileContent
GET	/file/status	Dohvati status za praćene datoteke	File[]

/find/file parametri upita

• query (obavezno) — niz za pretragu (fuzzy podudaranje)
• type (opcionalno) — ograniči rezultate na "file" ili "directory"
• directory (opcionalno) — nadjačaj korijen projekta za pretragu
• limit (opcionalno) — maksimalni rezultati (1–200)
• dirs (opcionalno) — zastarjela zastavica ("false" vraća samo datoteke)

---

Alati (Eksperimentalno)

Metoda	Putanja	Opis	Odgovor
GET	/experimental/tool/ids	Izlistaj sve ID-ove alata	ToolIDs
GET	/experimental/tool?provider=<p>&model=<m>	Izlistaj alate sa JSON šemama za model	ToolList

---

LSP, Formateri & MCP

Metoda	Putanja	Opis	Odgovor
GET	/lsp	Dohvati status LSP servera	LSPStatus[]
GET	/formatter	Dohvati status formatera	FormatterStatus[]
GET	/mcp	Dohvati status MCP servera	{ [name: string]: MCPStatus }
POST	/mcp	Dodaj MCP server dinamički	body: { name, config }, returns MCP status object

---

Agenti

Metoda	Putanja	Opis	Odgovor
GET	/agent	Izlistaj sve dostupne agente	Agent[]

---

Bilježenje

Metoda	Putanja	Opis	Odgovor
POST	/log	Upiši zapis dnevnika. Tijelo: { service, level, message, extra? }	boolean

---

TUI

Metoda	Putanja	Opis	Odgovor
POST	/tui/append-prompt	Dodaj tekst na prompt	boolean
POST	/tui/open-help	Otvori dijalog za pomoć	boolean
POST	/tui/open-sessions	Otvori selektor sesija	boolean
POST	/tui/open-themes	Otvori selektor tema	boolean
POST	/tui/open-models	Otvori selektor modela	boolean
POST	/tui/submit-prompt	Pošalji trenutni prompt	boolean
POST	/tui/clear-prompt	Očisti prompt	boolean
POST	/tui/execute-command	Izvrši naredbu ({ command })	boolean
POST	/tui/show-toast	Prikaži toast obavijest ({ title?, message, variant })	boolean
GET	/tui/control/next	Čekaj sljedeći kontrolni zahtjev	Control request object
POST	/tui/control/response	Odgovori na kontrolni zahtjev ({ body })	boolean

---

Autentifikacija

Metoda	Putanja	Opis	Odgovor
PUT	/auth/:id	Postavi autentifikacijske vjerodajnice. Tijelo mora odgovarati shemi provajdera	boolean

---

Događaji

Metoda	Putanja	Opis	Odgovor
GET	/event	Tok događaja koje šalje server. Prvi događaj je server.connected, zatim bus događaji	Server-sent events stream

---

Dokumentacija

Metoda	Putanja	Opis	Odgovor
GET	/doc	OpenAPI 3.1 specifikacija	HTML stranica sa OpenAPI specifikacijom