packages/web/src/content/docs/bs/cli.mdx
import { Tabs, TabItem } from "@astrojs/starlight/components"
OpenCode CLI po defaultu pokreće TUI kada se pokrene bez ikakvih argumenata.
opencode
Ali takođe prihvata naredbe kao što je dokumentovano na ovoj stranici. Ovo vam omogućava programsku interakciju sa OpenCode.
opencode run "Explain how closures work in JavaScript"
Pokrenite OpenCode terminalski korisnički interfejs.
opencode [project]
| Opcija | Kratko | Opis |
|---|---|---|
| <nobr><code>{"--continue"}</code></nobr> | -c | Nastavite posljednju sesiju |
| <nobr><code>{"--session"}</code></nobr> | -s | ID sesije za nastavak |
| <nobr><code>{"--fork"}</code></nobr> | Forkujte sesiju pri nastavku (koristiti sa --continue ili --session) | |
| <nobr><code>{"--prompt"}</code></nobr> | Prompt za upotrebu | |
| <nobr><code>{"--model"}</code></nobr> | -m | Model za korištenje u obliku provider/model |
| <nobr><code>{"--agent"}</code></nobr> | Agent za korištenje | |
| <nobr><code>{"--port"}</code></nobr> | Port na kojem treba slušati | |
| <nobr><code>{"--hostname"}</code></nobr> | Hostname na kojem treba slušati |
OpenCode CLI takođe ima sljedeće naredbe.
Upravljajte OpenCode agentima.
opencode agent [command]
Priključite terminal na već pokrenut OpenCode backend server pokrenut putem serve ili web naredbi.
opencode attach [url]
Ovo omogućava korištenje TUI-ja sa udaljenim OpenCode backend-om. Na primjer:
# Start the backend server for web/mobile access
opencode web --port 4096 --hostname 0.0.0.0
# In another terminal, attach the TUI to the running backend
opencode attach http://10.20.30.40:4096
| Opcija | Kratko | Opis |
|---|---|---|
| <nobr><code>{"--dir"}</code></nobr> | Radni direktorij za pokretanje TUI-a | |
| <nobr><code>{"--continue"}</code></nobr> | -c | Nastavi posljednju sesiju |
| <nobr><code>{"--session"}</code></nobr> | -s | ID sesije za nastavak |
| <nobr><code>{"--fork"}</code></nobr> | Forkuj sesiju prilikom nastavka (koristite sa --continue ili --session) | |
| <nobr><code>{"--password"}</code></nobr> | -p | Lozinka za osnovnu autentifikaciju (zadano: OPENCODE_SERVER_PASSWORD) |
| <nobr><code>{"--username"}</code></nobr> | -u | Korisničko ime za osnovnu autentifikaciju (zadano: OPENCODE_SERVER_USERNAME ili opencode) |
Kreirajte novog agenta s prilagođenom konfiguracijom.
opencode agent create
Ova naredba će vas voditi kroz kreiranje novog agenta sa prilagođenim sistemskim promptom i konfiguracijom alata.
Navedite sve dostupne agente.
opencode agent list
Naredba za upravljanje vjerodajnicama i prijavom za provajdere.
opencode auth [command]
OpenCode pokreće lista provajdera na Models.dev, tako da možete koristiti opencode auth login da konfigurirate API ključeve za bilo kojeg provajdera kojeg želite koristiti. Ovo je pohranjeno u ~/.local/share/opencode/auth.json.
opencode auth login
Kada se OpenCode pokrene, učitava dobavljače iz datoteke vjerodajnica. I ako postoje neki ključevi definirani u vašim okruženjima ili .env fajl u vašem projektu.
Navodi sve autentifikovane dobavljače pohranjene u datoteci vjerodajnica.
opencode auth list
Ili kratka verzija.
opencode auth ls
Odjavljuje vas s provajdera tako što ga briše iz datoteke vjerodajnica.
opencode auth logout
Upravljajte GitHub agentom za automatizaciju repozitorija.
opencode github [command]
Instalirajte GitHub agenta u svoj repozitorij.
opencode github install
Ovo postavlja neophodni tok rada GitHub Actions i vodi vas kroz proces konfiguracije. Saznajte više.
Pokrenite GitHub agent. Ovo se obično koristi u GitHub Actions.
opencode github run
| Opcija | Opis |
|---|---|
| <nobr><code>{"--event"}</code></nobr> | GitHub mock event za pokretanje agenta |
| <nobr><code>{"--token"}</code></nobr> | GitHub Personal Access Token |
Upravljajte Model Context Protocol (MCP) serverima.
opencode mcp [command]
Dodajte MCP server svojoj konfiguraciji.
opencode mcp add
Ova naredba će vas voditi kroz dodavanje lokalnog ili udaljenog MCP servera.
Navedite sve konfigurirane MCP servere i njihov status veze.
opencode mcp list
Ili koristite kratku verziju.
opencode mcp ls
Autentifikujte se sa MCP serverom koji je omogućen za OAuth.
opencode mcp auth [name]
Ako ne navedete ime servera, od vas će biti zatraženo da izaberete neki od dostupnih servera koji podržavaju OAuth. Također možete navesti servere koji podržavaju OAuth i njihov status autentifikacije.
opencode mcp auth list
Ili koristite kratku verziju.
opencode mcp auth ls
Uklonite OAuth vjerodajnice za MCP server.
opencode mcp logout [name]
Otklanjanje grešaka (debug) OAuth veze sa MCP serverom.
opencode mcp debug <name>
Navedite sve dostupne modele konfiguriranih provajdera.
opencode models [provider]
Ova naredba prikazuje sve modele dostupne kod vaših konfiguriranih provajdera u formatu provider/model.
Ovo je korisno za pronalaženje tačnog naziva modela za korištenje u vašoj konfiguraciji.
Opciono možete proslijediti ID provajdera za filtriranje modela po tom dobavljaču.
opencode models anthropic
| Opcija | Opis |
|---|---|
| <nobr><code>{"--refresh"}</code></nobr> | Osvježite keš modela sa models.dev |
| <nobr><code>{"--verbose"}</code></nobr> | Koristite detaljniji izlaz modela (uključuje metapodatke poput troškova) |
Koristite --refresh zastavicu da ažurirate keširanu listu modela. Ovo je korisno kada su novi modeli dodani provajderu i želite da ih vidite u OpenCode.
opencode models --refresh
Pokrenite OpenCode u neinteraktivnom modu tako što ćete direktno proslijediti prompt.
opencode run [message..]
Ovo je korisno za skriptiranje, automatizaciju ili kada želite brz odgovor bez pokretanja punog TUI-ja. Na primjer:
opencode run Explain the use of context in Go
Također možete priključiti pokrenutu opencode serve instancu kako biste izbjegli vrijeme hladnog pokretanja MCP servera pri svakom pokretanju:
# Start a headless server in one terminal
opencode serve
# In another terminal, run commands that attach to it
opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"
| Opcija | Kratko | Opis |
|---|---|---|
| <nobr><code>{"--command"}</code></nobr> | Naredba za pokretanje, koristite poruku za argumente | |
| <nobr><code>{"--continue"}</code></nobr> | -c | Nastavite posljednju sesiju |
| <nobr><code>{"--session"}</code></nobr> | -s | ID sesije za nastavak |
| <nobr><code>{"--fork"}</code></nobr> | Forkujte sesiju pri nastavku (koristiti sa --continue ili --session) | |
| <nobr><code>{"--share"}</code></nobr> | Podijelite sesiju | |
| <nobr><code>{"--model"}</code></nobr> | -m | Model za korištenje u obliku provider/model |
| <nobr><code>{"--agent"}</code></nobr> | Agent za korištenje | |
| <nobr><code>{"--file"}</code></nobr> | -f | Fajlovi koje treba priložiti poruci |
| <nobr><code>{"--format"}</code></nobr> | Format: default (formatiran) ili json (sirovi JSON događaji) | |
| <nobr><code>{"--title"}</code></nobr> | Naslov sesije (koristi skraćeni prompt ako nije navedena vrijednost) | |
| <nobr><code>{"--attach"}</code></nobr> | Priključite na pokrenuti OpenCode server (npr. http://localhost:4096) | |
| <nobr><code>{"--password"}</code></nobr> | -p | Lozinka za osnovnu autentifikaciju (zadano: OPENCODE_SERVER_PASSWORD) |
| <nobr><code>{"--username"}</code></nobr> | -u | Korisničko ime za osnovnu autentifikaciju (zadano: OPENCODE_SERVER_USERNAME ili opencode) |
| <nobr><code>{"--dir"}</code></nobr> | Direktorij za pokretanje, ili putanja na udaljenom serveru pri spajanju | |
| <nobr><code>{"--variant"}</code></nobr> | Varijanta modela (napor zaključivanja specifičan za provajdera) | |
| <nobr><code>{"--thinking"}</code></nobr> | Prikaži blokove razmišljanja | |
| <nobr><code>{"--port"}</code></nobr> | Port za lokalni server (zadano na nasumični port) |
Pokrenite OpenCode headless server za API pristup. Pogledajte server docs za kompletan HTTP interfejs.
opencode serve
Ovo pokreće HTTP server koji pruža API pristup funkcionalnosti OpenCode-a bez TUI interfejsa. Postavite OPENCODE_SERVER_PASSWORD da omogućite HTTP osnovnu auth (korisničko ime je zadano na opencode).
| Opcija | Opis |
|---|---|
| <nobr><code>{"--port"}</code></nobr> | Port na kojem treba slušati |
| <nobr><code>{"--hostname"}</code></nobr> | Hostname na kojem treba slušati |
| <nobr><code>{"--mdns"}</code></nobr> | Omogući mDNS otkrivanje |
| <nobr><code>{"--cors"}</code></nobr> | Dodatni origin(i) pretraživača koji dozvoljavaju CORS |
Upravljajte OpenCode sesijama.
opencode session [command]
Navedite sve OpenCode sesije.
opencode session list
| Opcija | Kratko | Opis |
|---|---|---|
| <nobr><code>{"--max-count"}</code></nobr> | -n | Ograničenje na N najnovijih sesija |
| <nobr><code>{"--format"}</code></nobr> | Izlazni format: table ili json (table) |
Prikaži statistiku upotrebe tokena i troškova za vaše OpenCode sesije.
opencode stats
| Opcija | Opis |
|---|---|
| <nobr><code>{"--days"}</code></nobr> | Prikaži statistiku za zadnjih N dana (sva vremena) |
| <nobr><code>{"--tools"}</code></nobr> | Broj alata za prikaz (svi) |
| <nobr><code>{"--models"}</code></nobr> | Prikaži raščlambu korištenja modela (skriveno prema zadanim postavkama). Proslijedite broj za prikaz top N |
| <nobr><code>{"--project"}</code></nobr> | Filtriraj po projektu (svi projekti, prazan niz: trenutni projekt) |
Izvezite podatke sesije kao JSON.
opencode export [sessionID]
Ako ne unesete ID sesije, od vas će biti zatraženo da odaberete neku od dostupnih sesija.
Uvezite podatke sesije iz JSON datoteke ili OpenCode dijeljenog URL-a.
opencode import <file>
Možete uvesti iz lokalne datoteke ili OpenCode dijeljenog URL-a.
opencode import session.json
opencode import https://opncd.ai/s/abc123
Pokrenite OpenCode headless server sa web interfejsom.
opencode web
Ovo pokreće HTTP server i otvara web pretraživač za pristup OpenCode-u preko web interfejsa. Postavite OPENCODE_SERVER_PASSWORD da omogućite HTTP osnovnu auth (korisničko ime je zadano na opencode).
| Opcija | Opis |
|---|---|
| <nobr><code>{"--port"}</code></nobr> | Port na kojem treba slušati |
| <nobr><code>{"--hostname"}</code></nobr> | Hostname na kojem treba slušati |
| <nobr><code>{"--mdns"}</code></nobr> | Omogući mDNS otkrivanje |
| <nobr><code>{"--cors"}</code></nobr> | Dodatni origin(i) pretraživača koji dozvoljavaju CORS |
Pokrenite ACP (Agent Client Protocol) server.
opencode acp
Ova naredba pokreće ACP server koji komunicira preko stdin/stdout koristeći nd-JSON.
| Opcija | Opis |
|---|---|
| <nobr><code>{"--cwd"}</code></nobr> | Radni direktorij |
| <nobr><code>{"--port"}</code></nobr> | Port na kojem treba slušati |
| <nobr><code>{"--hostname"}</code></nobr> | Hostname na kojem slušati |
Deinstalirajte OpenCode i uklonite sve povezane datoteke.
opencode uninstall
| Opcija | Kratko | Opis |
|---|---|---|
| <nobr><code>{"--keep-config"}</code></nobr> | -c | Sačuvajte konfiguracijske datoteke |
| <nobr><code>{"--keep-data"}</code></nobr> | -d | Sačuvajte podatke i snimke sesije |
| <nobr><code>{"--dry-run"}</code></nobr> | Pokažite šta bi bilo uklonjeno bez uklanjanja | |
| <nobr><code>{"--force"}</code></nobr> | -f | Preskoči upite za potvrdu |
Ažurira OpenCode na najnoviju verziju ili određenu verziju.
opencode upgrade [target]
Za nadogradnju na najnoviju verziju.
opencode upgrade
Za nadogradnju na određenu verziju.
opencode upgrade v0.1.48
| Opcija | Kratko | Opis |
|---|---|---|
| <nobr><code>{"--method"}</code></nobr> | -m | Korišteni način instalacije; curl, npm, pnpm, bun, brew |
OpenCode CLI prihvata sljedeće globalne zastavice.
| Opcija | Kratko | Opis |
|---|---|---|
| <nobr><code>{"--help"}</code></nobr> | -h | Prikaži pomoć |
| <nobr><code>{"--version"}</code></nobr> | -v | Ispiši broj verzije |
| <nobr><code>{"--print-logs"}</code></nobr> | Ispis logova u stderr | |
| <nobr><code>{"--log-level"}</code></nobr> | Nivo logovanja (DEBUG, INFO, WARN, ERROR) |
OpenCode se može konfigurirati pomoću varijabli okruženja.
| Varijabla | Tip | Opis |
|---|---|---|
OPENCODE_AUTO_SHARE | boolean | Automatski dijeli sesije |
OPENCODE_GIT_BASH_PATH | string | Putanja do Git Bash izvršne datoteke na Windows-u |
OPENCODE_CONFIG | string | Putanja do konfiguracijskog fajla |
OPENCODE_TUI_CONFIG | string | Putanja do TUI konfiguracijskog fajla |
OPENCODE_CONFIG_DIR | string | Putanja do konfiguracijskog direktorija |
OPENCODE_CONFIG_CONTENT | string | Inline json konfiguracijski sadržaj |
OPENCODE_DISABLE_AUTOUPDATE | boolean | Onemogući automatske provjere ažuriranja |
OPENCODE_DISABLE_PRUNE | boolean | Onemogući brisanje (pruning) starih podataka |
OPENCODE_DISABLE_TERMINAL_TITLE | boolean | Onemogući automatsko ažuriranje naslova terminala |
OPENCODE_PERMISSION | string | Inline json konfiguracija dozvola |
OPENCODE_DISABLE_DEFAULT_PLUGINS | boolean | Onemogući podrazumijevane dodatke (plugins) |
OPENCODE_DISABLE_LSP_DOWNLOAD | boolean | Onemogući automatsko preuzimanje LSP servera |
OPENCODE_ENABLE_EXPERIMENTAL_MODELS | boolean | Omogući eksperimentalne modele |
OPENCODE_DISABLE_AUTOCOMPACT | boolean | Onemogući automatsko sažimanje konteksta |
OPENCODE_DISABLE_CLAUDE_CODE | boolean | Onemogući čitanje iz .claude (prompt + vještine) |
OPENCODE_DISABLE_CLAUDE_CODE_PROMPT | boolean | Onemogući čitanje ~/.claude/CLAUDE.md |
OPENCODE_DISABLE_CLAUDE_CODE_SKILLS | boolean | Onemogući učitavanje .claude/skills |
OPENCODE_DISABLE_MODELS_FETCH | boolean | Onemogući dohvaćanje modela iz udaljenih izvora |
OPENCODE_FAKE_VCS | string | Lažni VCS provajder za potrebe testiranja |
OPENCODE_CLIENT | string | Identifikator klijenta (zadano na cli) |
OPENCODE_ENABLE_EXA | boolean | Omogući Exa alate za web pretraživanje |
OPENCODE_SERVER_PASSWORD | string | Omogući osnovnu autentifikaciju za serve/web |
OPENCODE_SERVER_USERNAME | string | Poništi osnovno korisničko ime autentifikacije (zadano opencode) |
OPENCODE_MODELS_URL | string | Prilagođeni URL za dohvaćanje konfiguracije modela |
Ove varijable okruženja omogućavaju eksperimentalne karakteristike koje se mogu promijeniti ili ukloniti.
| Varijabla | Tip | Opis |
|---|---|---|
OPENCODE_EXPERIMENTAL | boolean | Omogući sve eksperimentalne funkcije |
OPENCODE_EXPERIMENTAL_ICON_DISCOVERY | boolean | Omogući otkrivanje ikona |
OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT | boolean | Onemogući kopiranje pri odabiru u TUI |
OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS | number | Zadano vremensko ograničenje za bash naredbe u ms |
OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX | number | Maksimalni izlazni tokeni za LLM odgovore |
OPENCODE_EXPERIMENTAL_FILEWATCHER | boolean | Omogući praćenje datoteka za cijeli direktorij |
OPENCODE_EXPERIMENTAL_OXFMT | boolean | Omogući oxfmt formatter |
OPENCODE_EXPERIMENTAL_LSP_TOOL | boolean | Omogući eksperimentalni LSP alat |
OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER | boolean | Onemogući praćenje datoteka |
OPENCODE_EXPERIMENTAL_EXA | boolean | Omogući eksperimentalne Exa funkcije |
OPENCODE_EXPERIMENTAL_LSP_TY | boolean | Omogući TY LSP za python datoteke |
OPENCODE_EXPERIMENTAL_MARKDOWN | boolean | Omogući eksperimentalne Markdown funkcije |
OPENCODE_EXPERIMENTAL_PLAN_MODE | boolean | Omogući Plan mod |