602 lines
19 KiB
Markdown
602 lines
19 KiB
Markdown
---
|
|
title: CLI
|
|
description: OpenCode CLI opcije i naredbe.
|
|
---
|
|
|
|
import { Tabs, TabItem } from "@astrojs/starlight/components"
|
|
|
|
OpenCode CLI po defaultu pokreće [TUI](/docs/tui) kada se pokrene bez ikakvih argumenata.
|
|
|
|
```bash
|
|
opencode
|
|
```
|
|
|
|
Ali takođe prihvata naredbe kao što je dokumentovano na ovoj stranici. Ovo vam omogućava programsku interakciju sa OpenCode.
|
|
|
|
```bash
|
|
opencode run "Explain how closures work in JavaScript"
|
|
```
|
|
|
|
---
|
|
|
|
### tui
|
|
|
|
Pokrenite OpenCode terminalski korisnički interfejs.
|
|
|
|
```bash
|
|
opencode [project]
|
|
```
|
|
|
|
#### Opcije
|
|
|
|
| Opcija | Kratko | Opis |
|
|
| ------------ | ------ | ------------------------------------------------------------------------ |
|
|
| `--continue` | `-c` | Nastavite posljednju sesiju |
|
|
| `--session` | `-s` | ID sesije za nastavak |
|
|
| `--fork` | | Forkujte sesiju pri nastavku (koristiti sa `--continue` ili `--session`) |
|
|
| `--prompt` | | Prompt za upotrebu |
|
|
| `--model` | `-m` | Model za korištenje u obliku provider/model |
|
|
| `--agent` | | Agent za korištenje |
|
|
| `--port` | | Port na kojem treba slušati |
|
|
| `--hostname` | | Hostname na kojem treba slušati |
|
|
|
|
---
|
|
|
|
## Naredbe
|
|
|
|
OpenCode CLI takođe ima sljedeće naredbe.
|
|
|
|
---
|
|
|
|
### agent
|
|
|
|
Upravljajte OpenCode agentima.
|
|
|
|
```bash
|
|
opencode agent [command]
|
|
```
|
|
|
|
---
|
|
|
|
### attach
|
|
|
|
Priključite terminal na već pokrenut OpenCode backend server pokrenut putem `serve` ili `web` naredbi.
|
|
|
|
```bash
|
|
opencode attach [url]
|
|
```
|
|
|
|
Ovo omogućava korištenje TUI-ja sa udaljenim OpenCode backend-om. Na primjer:
|
|
|
|
```bash
|
|
# 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
|
|
```
|
|
|
|
#### Opcije
|
|
|
|
| Opcija | Kratko | Opis |
|
|
| ----------- | ------ | ------------------------------------ |
|
|
| `--dir` | | Radni direktorij za pokretanje TUI-a |
|
|
| `--session` | `-s` | ID sesije za nastavak |
|
|
|
|
---
|
|
|
|
#### create
|
|
|
|
Kreirajte novog agenta s prilagođenom konfiguracijom.
|
|
|
|
```bash
|
|
opencode agent create
|
|
```
|
|
|
|
Ova naredba će vas voditi kroz kreiranje novog agenta sa prilagođenim sistemskim promptom i konfiguracijom alata.
|
|
|
|
---
|
|
|
|
#### list
|
|
|
|
Navedite sve dostupne agente.
|
|
|
|
```bash
|
|
opencode agent list
|
|
```
|
|
|
|
---
|
|
|
|
### auth
|
|
|
|
Naredba za upravljanje vjerodajnicama i prijavom za provajdere.
|
|
|
|
```bash
|
|
opencode auth [command]
|
|
```
|
|
|
|
---
|
|
|
|
#### login
|
|
|
|
OpenCode pokreće lista provajdera na [Models.dev](https://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`.
|
|
|
|
```bash
|
|
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.
|
|
|
|
---
|
|
|
|
#### list
|
|
|
|
Navodi sve autentifikovane dobavljače pohranjene u datoteci vjerodajnica.
|
|
|
|
```bash
|
|
opencode auth list
|
|
```
|
|
|
|
Ili kratka verzija.
|
|
|
|
```bash
|
|
opencode auth ls
|
|
```
|
|
|
|
---
|
|
|
|
#### logout
|
|
|
|
Odjavljuje vas s provajdera tako što ga briše iz datoteke vjerodajnica.
|
|
|
|
```bash
|
|
opencode auth logout
|
|
```
|
|
|
|
---
|
|
|
|
### github
|
|
|
|
Upravljajte GitHub agentom za automatizaciju repozitorija.
|
|
|
|
```bash
|
|
opencode github [command]
|
|
```
|
|
|
|
---
|
|
|
|
#### install
|
|
|
|
Instalirajte GitHub agenta u svoj repozitorij.
|
|
|
|
```bash
|
|
opencode github install
|
|
```
|
|
|
|
Ovo postavlja neophodni tok rada GitHub Actions i vodi vas kroz proces konfiguracije. [Saznajte više](/docs/github).
|
|
|
|
---
|
|
|
|
#### run
|
|
|
|
Pokrenite GitHub agent. Ovo se obično koristi u GitHub Actions.
|
|
|
|
```bash
|
|
opencode github run
|
|
```
|
|
|
|
##### Opcije
|
|
|
|
| Opcija | Opis |
|
|
| --------- | -------------------------------------- |
|
|
| `--event` | GitHub mock event za pokretanje agenta |
|
|
| `--token` | GitHub Personal Access Token |
|
|
|
|
---
|
|
|
|
### mcp
|
|
|
|
Upravljajte Model Context Protocol (MCP) serverima.
|
|
|
|
```bash
|
|
opencode mcp [command]
|
|
```
|
|
|
|
---
|
|
|
|
#### add
|
|
|
|
Dodajte MCP server svojoj konfiguraciji.
|
|
|
|
```bash
|
|
opencode mcp add
|
|
```
|
|
|
|
Ova naredba će vas voditi kroz dodavanje lokalnog ili udaljenog MCP servera.
|
|
|
|
---
|
|
|
|
#### list
|
|
|
|
Navedite sve konfigurirane MCP servere i njihov status veze.
|
|
|
|
```bash
|
|
opencode mcp list
|
|
```
|
|
|
|
Ili koristite kratku verziju.
|
|
|
|
```bash
|
|
opencode mcp ls
|
|
```
|
|
|
|
---
|
|
|
|
#### auth
|
|
|
|
Autentifikujte se sa MCP serverom koji je omogućen za OAuth.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
opencode mcp auth list
|
|
```
|
|
|
|
Ili koristite kratku verziju.
|
|
|
|
```bash
|
|
opencode mcp auth ls
|
|
```
|
|
|
|
---
|
|
|
|
#### logout
|
|
|
|
Uklonite OAuth vjerodajnice za MCP server.
|
|
|
|
```bash
|
|
opencode mcp logout [name]
|
|
```
|
|
|
|
---
|
|
|
|
#### debug
|
|
|
|
Otklanjanje grešaka (debug) OAuth veze sa MCP serverom.
|
|
|
|
```bash
|
|
opencode mcp debug <name>
|
|
```
|
|
|
|
---
|
|
|
|
### models
|
|
|
|
Navedite sve dostupne modele konfiguriranih provajdera.
|
|
|
|
```bash
|
|
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](/docs/config/).
|
|
Opciono možete proslijediti ID provajdera za filtriranje modela po tom dobavljaču.
|
|
|
|
```bash
|
|
opencode models anthropic
|
|
```
|
|
|
|
#### Opcije
|
|
|
|
| Opcija | Opis |
|
|
| ----------- | ------------------------------------------------------------------------ |
|
|
| `--refresh` | Osvježite keš modela sa models.dev |
|
|
| `--verbose` | 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.
|
|
|
|
```bash
|
|
opencode models --refresh
|
|
```
|
|
|
|
---
|
|
|
|
### run
|
|
|
|
Pokrenite OpenCode u neinteraktivnom modu tako što ćete direktno proslijediti prompt.
|
|
|
|
```bash
|
|
opencode run [message..]
|
|
```
|
|
|
|
Ovo je korisno za skriptiranje, automatizaciju ili kada želite brz odgovor bez pokretanja punog TUI-ja. Na primjer:
|
|
|
|
```bash "opencode run"
|
|
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:
|
|
|
|
```bash
|
|
# 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"
|
|
```
|
|
|
|
#### Opcije
|
|
|
|
| Opcija | Kratko | Opis |
|
|
| ------------ | ------ | ------------------------------------------------------------------------ |
|
|
| `--command` | | Naredba za pokretanje, koristite poruku za argumente |
|
|
| `--continue` | `-c` | Nastavite posljednju sesiju |
|
|
| `--session` | `-s` | ID sesije za nastavak |
|
|
| `--fork` | | Forkujte sesiju pri nastavku (koristiti sa `--continue` ili `--session`) |
|
|
| `--share` | | Podijelite sesiju |
|
|
| `--model` | `-m` | Model za korištenje u obliku provider/model |
|
|
| `--agent` | | Agent za korištenje |
|
|
| `--file` | `-f` | Fajlovi koje treba priložiti poruci |
|
|
| `--format` | | Format: default (formatiran) ili json (sirovi JSON događaji) |
|
|
| `--title` | | Naslov sesije (koristi skraćeni prompt ako nije navedena vrijednost) |
|
|
| `--attach` | | Priključite na pokrenuti OpenCode server (npr. http://localhost:4096) |
|
|
| `--port` | | Port za lokalni server (zadano na nasumični port) |
|
|
|
|
---
|
|
|
|
### serve
|
|
|
|
Pokrenite OpenCode headless server za API pristup. Pogledajte [server docs](/docs/server) za kompletan HTTP interfejs.
|
|
|
|
```bash
|
|
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`).
|
|
|
|
#### Opcije
|
|
|
|
| Opcija | Opis |
|
|
| ------------ | ----------------------------------------------------- |
|
|
| `--port` | Port na kojem treba slušati |
|
|
| `--hostname` | Hostname na kojem treba slušati |
|
|
| `--mdns` | Omogući mDNS otkrivanje |
|
|
| `--cors` | Dodatni origin(i) pretraživača koji dozvoljavaju CORS |
|
|
|
|
---
|
|
|
|
### session
|
|
|
|
Upravljajte OpenCode sesijama.
|
|
|
|
```bash
|
|
opencode session [command]
|
|
```
|
|
|
|
---
|
|
|
|
#### list
|
|
|
|
Navedite sve OpenCode sesije.
|
|
|
|
```bash
|
|
opencode session list
|
|
```
|
|
|
|
##### Opcije
|
|
|
|
| Opcija | Kratko | Opis |
|
|
| ------------- | ------ | -------------------------------------- |
|
|
| `--max-count` | `-n` | Ograničenje na N najnovijih sesija |
|
|
| `--format` | | Izlazni format: table ili json (table) |
|
|
|
|
---
|
|
|
|
### stats
|
|
|
|
Prikaži statistiku upotrebe tokena i troškova za vaše OpenCode sesije.
|
|
|
|
```bash
|
|
opencode stats
|
|
```
|
|
|
|
#### Opcije
|
|
|
|
| Opcija | Opis |
|
|
| ----------- | ---------------------------------------------------------------------------------------------------------- |
|
|
| `--days` | Prikaži statistiku za zadnjih N dana (sva vremena) |
|
|
| `--tools` | Broj alata za prikaz (svi) |
|
|
| `--models` | Prikaži raščlambu korištenja modela (skriveno prema zadanim postavkama). Proslijedite broj za prikaz top N |
|
|
| `--project` | Filtriraj po projektu (svi projekti, prazan niz: trenutni projekt) |
|
|
|
|
---
|
|
|
|
### export
|
|
|
|
Izvezite podatke sesije kao JSON.
|
|
|
|
```bash
|
|
opencode export [sessionID]
|
|
```
|
|
|
|
Ako ne unesete ID sesije, od vas će biti zatraženo da odaberete neku od dostupnih sesija.
|
|
|
|
---
|
|
|
|
### import
|
|
|
|
Uvezite podatke sesije iz JSON datoteke ili OpenCode dijeljenog URL-a.
|
|
|
|
```bash
|
|
opencode import <file>
|
|
```
|
|
|
|
Možete uvesti iz lokalne datoteke ili OpenCode dijeljenog URL-a.
|
|
|
|
```bash
|
|
opencode import session.json
|
|
opencode import https://opncd.ai/s/abc123
|
|
```
|
|
|
|
---
|
|
|
|
### web
|
|
|
|
Pokrenite OpenCode headless server sa web interfejsom.
|
|
|
|
```bash
|
|
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`).
|
|
|
|
#### Opcije
|
|
|
|
| Opcija | Opis |
|
|
| ------------ | ----------------------------------------------------- |
|
|
| `--port` | Port na kojem treba slušati |
|
|
| `--hostname` | Hostname na kojem treba slušati |
|
|
| `--mdns` | Omogući mDNS otkrivanje |
|
|
| `--cors` | Dodatni origin(i) pretraživača koji dozvoljavaju CORS |
|
|
|
|
---
|
|
|
|
### acp
|
|
|
|
Pokrenite ACP (Agent Client Protocol) server.
|
|
|
|
```bash
|
|
opencode acp
|
|
```
|
|
|
|
Ova naredba pokreće ACP server koji komunicira preko stdin/stdout koristeći nd-JSON.
|
|
|
|
#### Opcije
|
|
|
|
| Opcija | Opis |
|
|
| ------------ | --------------------------- |
|
|
| `--cwd` | Radni direktorij |
|
|
| `--port` | Port na kojem treba slušati |
|
|
| `--hostname` | Hostname na kojem slušati |
|
|
|
|
---
|
|
|
|
### uninstall
|
|
|
|
Deinstalirajte OpenCode i uklonite sve povezane datoteke.
|
|
|
|
```bash
|
|
opencode uninstall
|
|
```
|
|
|
|
#### Opcije
|
|
|
|
| Opcija | Kratko | Opis |
|
|
| --------------- | ------ | --------------------------------------------- |
|
|
| `--keep-config` | `-c` | Sačuvajte konfiguracijske datoteke |
|
|
| `--keep-data` | `-d` | Sačuvajte podatke i snimke sesije |
|
|
| `--dry-run` | | Pokažite šta bi bilo uklonjeno bez uklanjanja |
|
|
| `--force` | `-f` | Preskoči upite za potvrdu |
|
|
|
|
---
|
|
|
|
### upgrade
|
|
|
|
Ažurira OpenCode na najnoviju verziju ili određenu verziju.
|
|
|
|
```bash
|
|
opencode upgrade [target]
|
|
```
|
|
|
|
Za nadogradnju na najnoviju verziju.
|
|
|
|
```bash
|
|
opencode upgrade
|
|
```
|
|
|
|
Za nadogradnju na određenu verziju.
|
|
|
|
```bash
|
|
opencode upgrade v0.1.48
|
|
```
|
|
|
|
#### Opcije
|
|
|
|
| Opcija | Kratko | Opis |
|
|
| ---------- | ------ | ------------------------------------------------------- |
|
|
| `--method` | `-m` | Korišteni način instalacije; curl, npm, pnpm, bun, brew |
|
|
|
|
---
|
|
|
|
## Globalne opcije
|
|
|
|
OpenCode CLI prihvata sljedeće globalne zastavice.
|
|
|
|
| Opcija | Kratko | Opis |
|
|
| -------------- | ------ | ----------------------------------------- |
|
|
| `--help` | `-h` | Prikaži pomoć |
|
|
| `--version` | `-v` | Ispiši broj verzije |
|
|
| `--print-logs` | | Ispis logova u stderr |
|
|
| `--log-level` | | Nivo logovanja (DEBUG, INFO, WARN, ERROR) |
|
|
|
|
---
|
|
|
|
## Varijable okruženja
|
|
|
|
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_DISABLE_FILETIME_CHECK` | boolean | Onemogući provjeru vremena datoteke radi optimizacije |
|
|
| `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 |
|
|
|
|
---
|
|
|
|
### Eksperimentalno
|
|
|
|
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 |
|