--- title: Server description: Komunicirajte s opencode serverom preko HTTP-a. --- import config from "../../../../config.mjs" export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts` Komanda `opencode serve` pokrece headless HTTP server koji izlaže OpenAPI endpoint koji opencode klijent moze koristiti. --- ### Korištenje ```bash opencode serve [--port ] [--hostname ] [--cors ] ``` #### 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: ```bash 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`. ```bash 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](/docs/sdk). :::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](/docs/cli), pa se povezati na taj server. Endpoint [`/tui`](#tui) mozete koristiti za upravljanje TUI-jem kroz server. Na primjer, mozete unaprijed popuniti ili pokrenuti prompt. Ovaj setup koriste OpenCode [IDE](/docs/ide) pluginovi. --- ## Specifikacija Server objavljuje OpenAPI 3.1 specifikaciju koju mozete vidjeti na: ``` http://:/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=` | Traži tekst u datotekama | Array of match objects with `path`, `lines`, `line_number`, `absolute_offset`, `submatches` | | `GET` | `/find/file?query=` | Pronađi datoteke i direktorije po imenu | `string[]` (paths) | | `GET` | `/find/symbol?query=` | Pronađi simbole radnog prostora | Symbol[] | | `GET` | `/file?path=` | Izlistaj datoteke i direktorije | FileNode[] | | `GET` | `/file/content?path=

` | 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=

&model=` | 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 |