CLI

Matrix CLI opcije i naredbe.

Matrix CLI po defaultu pokreće TUI kada se pokrene bez ikakvih argumenata.

matrix

Ali takođe prihvata naredbe kao što je dokumentovano na ovoj stranici. Ovo vam omogućava programsku interakciju sa Matrix.

matrix run "Explain how closures work in JavaScript"

tui

Pokrenite Matrix terminalski korisnički interfejs.

matrix [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

Matrix CLI takođe ima sljedeće naredbe.

agent

Upravljajte Matrix agentima.

matrix agent [command]

attach

Priključite terminal na već pokrenut Matrix backend server pokrenut putem serve ili web naredbi.

matrix attach [url]

Ovo omogućava korištenje TUI-ja sa udaljenim Matrix backend-om. Na primjer:

# Start the backend server for web/mobile access
matrix web --port 4096 --hostname 0.0.0.0

# In another terminal, attach the TUI to the running backend
matrix 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.

matrix agent create

Ova naredba će vas voditi kroz kreiranje novog agenta sa prilagođenim sistemskim promptom i konfiguracijom alata.

list

Navedite sve dostupne agente.

matrix agent list

auth

Naredba za upravljanje vjerodajnicama i prijavom za provajdere.

matrix auth [command]

Matrix pokreće lista provajdera na Models.dev, tako da možete koristiti matrix auth login da konfigurirate API ključeve za bilo kojeg provajdera kojeg želite koristiti. Ovo je pohranjeno u ~/.local/share/matrix/auth.json.

matrix auth login

Kada se Matrix 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.

matrix auth list

Ili kratka verzija.

matrix auth ls

logout

Odjavljuje vas s provajdera tako što ga briše iz datoteke vjerodajnica.

matrix auth logout

github

Upravljajte GitHub agentom za automatizaciju repozitorija.

matrix github [command]

install

Instalirajte GitHub agenta u svoj repozitorij.

matrix github install

Ovo postavlja neophodni tok rada GitHub Actions i vodi vas kroz proces konfiguracije. Saznajte više.

run

Pokrenite GitHub agent. Ovo se obično koristi u GitHub Actions.

matrix github run

Opcije

Opcija	Opis
`--event`	GitHub mock event za pokretanje agenta
`--token`	GitHub Personal Access Token

mcp

Upravljajte Model Context Protocol (MCP) serverima.

matrix mcp [command]

add

Dodajte MCP server svojoj konfiguraciji.

matrix mcp add

Ova naredba će vas voditi kroz dodavanje lokalnog ili udaljenog MCP servera.

list

Navedite sve konfigurirane MCP servere i njihov status veze.

matrix mcp list

Ili koristite kratku verziju.

matrix mcp ls

auth

Autentifikujte se sa MCP serverom koji je omogućen za OAuth.

matrix 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.

matrix mcp auth list

Ili koristite kratku verziju.

matrix mcp auth ls

logout

Uklonite OAuth vjerodajnice za MCP server.

matrix mcp logout [name]

debug

Otklanjanje grešaka (debug) OAuth veze sa MCP serverom.

matrix mcp debug <name>

models

Navedite sve dostupne modele konfiguriranih provajdera.

matrix 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.

matrix 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 Matrix.

matrix models --refresh

run

Pokrenite Matrix u neinteraktivnom modu tako što ćete direktno proslijediti prompt.

matrix run [message..]

Ovo je korisno za skriptiranje, automatizaciju ili kada želite brz odgovor bez pokretanja punog TUI-ja. Na primjer:

matrix run Explain the use of context in Go

Također možete priključiti pokrenutu matrix serve instancu kako biste izbjegli vrijeme hladnog pokretanja MCP servera pri svakom pokretanju:

# Start a headless server in one terminal
matrix serve

# In another terminal, run commands that attach to it
matrix 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 Matrix server (npr. http://localhost:4096)
`--port`		Port za lokalni server (zadano na nasumični port)

serve

Pokrenite Matrix headless server za API pristup. Pogledajte server docs za kompletan HTTP interfejs.

matrix serve

Ovo pokreće HTTP server koji pruža API pristup funkcionalnosti Matrix-a bez TUI interfejsa. Postavite MATRIX_SERVER_PASSWORD da omogućite HTTP osnovnu auth (korisničko ime je zadano na matrix).

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 Matrix sesijama.

matrix session [command]

list

Navedite sve Matrix sesije.

matrix 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 Matrix sesije.

matrix 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.

matrix 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 Matrix dijeljenog URL-a.

matrix import <file>

Možete uvesti iz lokalne datoteke ili Matrix dijeljenog URL-a.

matrix import session.json
matrix import https://opncd.ai/s/abc123

web

Pokrenite Matrix headless server sa web interfejsom.

matrix web

Ovo pokreće HTTP server i otvara web pretraživač za pristup Matrix-u preko web interfejsa. Postavite MATRIX_SERVER_PASSWORD da omogućite HTTP osnovnu auth (korisničko ime je zadano na matrix).

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.

matrix 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 Matrix i uklonite sve povezane datoteke.

matrix 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 Matrix na najnoviju verziju ili određenu verziju.

matrix upgrade [target]

Za nadogradnju na najnoviju verziju.

matrix upgrade

Za nadogradnju na određenu verziju.

matrix upgrade v0.1.48

Opcije

Opcija	Kratko	Opis
`--method`	`-m`	Korišteni način instalacije; curl, npm, pnpm, bun, brew

Globalne opcije

Matrix 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

Matrix se može konfigurirati pomoću varijabli okruženja.

Varijabla	Tip	Opis
`MATRIX_AUTO_SHARE`	boolean	Automatski dijeli sesije
`MATRIX_GIT_BASH_PATH`	string	Putanja do Git Bash izvršne datoteke na Windows-u
`MATRIX_CONFIG`	string	Putanja do konfiguracijskog fajla
`MATRIX_TUI_CONFIG`	string	Putanja do TUI konfiguracijskog fajla
`MATRIX_CONFIG_DIR`	string	Putanja do konfiguracijskog direktorija
`MATRIX_CONFIG_CONTENT`	string	Inline json konfiguracijski sadržaj
`MATRIX_DISABLE_AUTOUPDATE`	boolean	Onemogući automatske provjere ažuriranja
`MATRIX_DISABLE_PRUNE`	boolean	Onemogući brisanje (pruning) starih podataka
`MATRIX_DISABLE_TERMINAL_TITLE`	boolean	Onemogući automatsko ažuriranje naslova terminala
`MATRIX_PERMISSION`	string	Inline json konfiguracija dozvola
`MATRIX_DISABLE_DEFAULT_PLUGINS`	boolean	Onemogući podrazumijevane dodatke (plugins)
`MATRIX_DISABLE_LSP_DOWNLOAD`	boolean	Onemogući automatsko preuzimanje LSP servera
`MATRIX_ENABLE_EXPERIMENTAL_MODELS`	boolean	Omogući eksperimentalne modele
`MATRIX_DISABLE_AUTOCOMPACT`	boolean	Onemogući automatsko sažimanje konteksta
`MATRIX_DISABLE_CLAUDE_CODE`	boolean	Onemogući čitanje iz `.claude` (prompt + vještine)
`MATRIX_DISABLE_CLAUDE_CODE_PROMPT`	boolean	Onemogući čitanje `~/.claude/CLAUDE.md`
`MATRIX_DISABLE_CLAUDE_CODE_SKILLS`	boolean	Onemogući učitavanje `.claude/skills`
`MATRIX_DISABLE_MODELS_FETCH`	boolean	Onemogući dohvaćanje modela iz udaljenih izvora
`MATRIX_FAKE_VCS`	string	Lažni VCS provajder za potrebe testiranja
`MATRIX_DISABLE_FILETIME_CHECK`	boolean	Onemogući provjeru vremena datoteke radi optimizacije
`MATRIX_CLIENT`	string	Identifikator klijenta (zadano na `cli`)
`MATRIX_ENABLE_EXA`	boolean	Omogući Exa alate za web pretraživanje
`MATRIX_SERVER_PASSWORD`	string	Omogući osnovnu autentifikaciju za `serve`/`web`
`MATRIX_SERVER_USERNAME`	string	Poništi osnovno korisničko ime autentifikacije (zadano `matrix`)
`MATRIX_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
`MATRIX_EXPERIMENTAL`	boolean	Omogući sve eksperimentalne funkcije
`MATRIX_EXPERIMENTAL_ICON_DISCOVERY`	boolean	Omogući otkrivanje ikona
`MATRIX_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolean	Onemogući kopiranje pri odabiru u TUI
`MATRIX_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	number	Zadano vremensko ograničenje za bash naredbe u ms
`MATRIX_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	number	Maksimalni izlazni tokeni za LLM odgovore
`MATRIX_EXPERIMENTAL_FILEWATCHER`	boolean	Omogući praćenje datoteka za cijeli direktorij
`MATRIX_EXPERIMENTAL_OXFMT`	boolean	Omogući oxfmt formatter
`MATRIX_EXPERIMENTAL_LSP_TOOL`	boolean	Omogući eksperimentalni LSP alat
`MATRIX_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolean	Onemogući praćenje datoteka
`MATRIX_EXPERIMENTAL_EXA`	boolean	Omogući eksperimentalne Exa funkcije
`MATRIX_EXPERIMENTAL_LSP_TY`	boolean	Omogući TY LSP za python datoteke
`MATRIX_EXPERIMENTAL_MARKDOWN`	boolean	Omogući eksperimentalne Markdown funkcije
`MATRIX_EXPERIMENTAL_PLAN_MODE`	boolean	Omogući Plan mod