CLI

Matrix CLI-alternativer og kommandoer.

Matrix CLI starter som standard TUI når den kjøres uten noen argumenter.

matrix

Men den godtar også kommandoer som dokumentert på denne siden. Dette lar deg samhandle med Matrix programmatisk.

matrix run "Explain how closures work in JavaScript"

tui

Start Matrix-terminalbrukergrensesnittet.

matrix [project]

Flagg

Flagg	Kort	Beskrivelse
`--continue`	`-c`	Fortsett siste økt
`--session`	`-s`	Økt ID for å fortsette
`--fork`		Forgren økten ved fortsettelse (bruk med `--continue` eller `--session`)
`--prompt`		Ledetekst som skal brukes
`--model`	`-m`	Modell å bruke i form av leverandør/modell
`--agent`		Agent som skal brukes
`--port`		Port å lytte på
`--hostname`		Vertsnavn å lytte på

Kommandoer

Matrix CLI har også følgende kommandoer.

agent

Administrer agenter for Matrix.

matrix agent [command]

attach

Koble en terminal til en allerede kjørende Matrix-backend-server startet via serve eller web kommandoer.

matrix attach [url]

Dette gjør det mulig å bruke TUI med en ekstern Matrix-backend. For eksempel:

# 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

Flagg

Flagg	Kort	Beskrivelse
`--dir`		Arbeidskatalog for å starte TUI i
`--session`	`-s`	Økt ID for å fortsette

create

Opprett en ny agent med tilpasset konfigurasjon.

matrix agent create

Denne kommandoen vil veilede deg gjennom å lage en ny agent med en tilpasset systemmelding og verktøykonfigurasjon.

list

List opp alle tilgjengelige agenter.

matrix agent list

auth

Kommando for administrasjon av påloggingsinformasjon og innlogging for leverandører.

matrix auth [command]

Matrix drives av leverandørlisten på Models.dev, så du kan bruke matrix auth login til å konfigurere API-nøkler for enhver leverandør du vil bruke. Dette er lagret i ~/.local/share/matrix/auth.json.

matrix auth login

Når Matrix starter opp, laster den leverandørene fra filen med påloggingsinformasjon. Og hvis det er noen nøkler definert i miljøene dine eller en .env-fil i prosjektet ditt.

list

Viser alle de autentiserte leverandørene som er lagret i filen med påloggingsinformasjon.

matrix auth list

Eller bruk kortversjonen.

matrix auth ls

logout

Logger deg ut av en leverandør ved å fjerne den fra filen med påloggingsinformasjon.

matrix auth logout

github

Administrer GitHub-agenten for depotautomatisering.

matrix github [command]

install

Installer GitHub-agenten i depotet ditt.

matrix github install

Dette setter opp den nødvendige GitHub Actions-arbeidsflyten og veileder deg gjennom konfigurasjonsprosessen. Finn ut mer.

run

Kjør GitHub-agenten. Dette brukes vanligvis i GitHub Actions.

matrix github run

Flagg

Flagg	Beskrivelse
`--event`	GitHub mock-hendelse agenten skal kjøres for
`--token`	GitHub personlig tilgangsnøkkel

mcp

Administrer Model Context Protocol-servere.

matrix mcp [command]

add

Legg til en MCP-server til konfigurasjonen.

matrix mcp add

Denne kommandoen vil veilede deg gjennom å legge til enten en lokal eller ekstern MCP-server.

list

Liste alle konfigurerte MCP-servere og deres tilkoblingsstatus.

matrix mcp list

Eller bruk den korte versjonen.

matrix mcp ls

auth

Autentiser med en OAuth-aktivert MCP-server.

matrix mcp auth [name]

Hvis du ikke oppgir et servernavn, blir du bedt om å velge blant tilgjengelige OAuth-kompatible servere.

Du kan også liste opp OAuth-kompatible servere og deres autentiseringsstatus.

matrix mcp auth list

Eller bruk den korte versjonen.

matrix mcp auth ls

logout

Fjern OAuth-påloggingsinformasjon for en MCP-server.

matrix mcp logout [name]

debug

Feilsøk OAuth-tilkoblingsproblemer for en MCP-server.

matrix mcp debug <name>

models

List opp alle tilgjengelige modeller fra konfigurerte leverandører.

matrix models [provider]

Denne kommandoen viser alle modeller som er tilgjengelige på tvers av dine konfigurerte leverandører i formatet provider/model.

Dette er nyttig for å finne ut det eksakte modellnavnet som skal brukes i din konfigurasjon.

Du kan eventuelt sende en leverandør ID for å filtrere modeller etter den leverandøren.

matrix models anthropic

Flagg

Flagg	Beskrivelse
`--refresh`	Oppdater modellbufferen fra models.dev
`--verbose`	Bruk mer detaljert modellutdata (inkluderer metadata som kostnader)

Bruk --refresh-flagget for å oppdatere den bufrede modelllisten. Dette er nyttig når nye modeller er lagt til en leverandør og du vil se dem i Matrix.

matrix models --refresh

run

Kjør Matrix i ikke-interaktiv modus ved å sende en melding direkte.

matrix run [message..]

Dette er nyttig for skripting, automatisering eller når du vil ha et raskt svar uten å starte hele TUI. For eksempel.

matrix run Explain the use of context in Go

Du kan også koble til en kjørende matrix serve-forekomst for å unngå MCP-serveres kaldstarttid ved hver kjøring:

# 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"

Flagg

Flagg	Kort	Beskrivelse
`--command`		Kommandoen for å kjøre, bruk melding for args
`--continue`	`-c`	Fortsett siste økt
`--session`	`-s`	Økt ID for å fortsette
`--fork`		Forgren økten ved fortsettelse (bruk med `--continue` eller `--session`)
`--share`		Del økten
`--model`	`-m`	Modell å bruke i form av leverandør/modell
`--agent`		Agent å bruke
`--file`	`-f`	Fil(er) som skal legges ved meldingen
`--format`		Format: standard (formatert) eller json (rå JSON hendelser)
`--title`		Tittel for økten (bruker avkortet ledetekst hvis ingen verdi er oppgitt)
`--attach`		Koble til en kjørende Matrix-server (f.eks. http://localhost:4096)
`--port`		Port for den lokale serveren (standard til tilfeldig port)

serve

Start en headless Matrix-server for API-tilgang. Sjekk ut server-dokumentene for hele HTTP-grensesnittet.

matrix serve

Dette starter en HTTP-server som gir API tilgang til Matrix-funksjonalitet uten TUI-grensesnittet. Sett MATRIX_SERVER_PASSWORD for å aktivere HTTP grunnleggende autentisering (brukernavn er standard til matrix).

Flagg

Flagg	Beskrivelse
`--port`	Port å lytte på
`--hostname`	Vertsnavn å lytte på
`--mdns`	Aktiver mDNS-oppdagelse
`--cors`	Ytterligere nettleseropprinnelse som tillater CORS

session

Administrer Matrix-økter.

matrix session [command]

list

List opp alle Matrix-økter.

matrix session list

Flagg

Flagg	Kort	Beskrivelse
`--max-count`	`-n`	Begrens til N siste økter
`--format`		Utdataformat: tabell eller json (tabell)

stats

Vis tokenbruk og kostnadsstatistikk for Matrix-øktene dine.

matrix stats

Flagg

Flagg	Beskrivelse
`--days`	Vis statistikk for de siste N dagene (hele tiden)
`--tools`	Antall verktøy som skal vises (alle)
`--models`	Vis oversikt over modellbruk (skjult som standard). Gi et tall for å vise topp N
`--project`	Filtrer etter prosjekt (alle prosjekter, tom streng: gjeldende prosjekt)

export

Eksporter øktdata som JSON.

matrix export [sessionID]

Hvis du ikke gir en økt ID, blir du bedt om å velge fra tilgjengelige økter.

import

Importer øktdata fra en JSON-fil eller en Matrix share-URL.

matrix import <file>

Du kan importere fra en lokal fil eller en Matrix share-URL.

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

web

Start en headless Matrix-server med et webgrensesnitt.

matrix web

Dette starter en HTTP-server og åpner en nettleser for å få tilgang til Matrix via et nettgrensesnitt. Sett MATRIX_SERVER_PASSWORD for å aktivere HTTP grunnleggende autentisering (brukernavn er standard til matrix).

Flagg

Flagg	Beskrivelse
`--port`	Port å lytte på
`--hostname`	Vertsnavn å lytte på
`--mdns`	Aktiver mDNS-oppdagelse
`--cors`	Ytterligere nettleseropprinnelse som tillater CORS

acp

Start en ACP (Agent Client Protocol) server.

matrix acp

Denne kommandoen starter en ACP-server som kommuniserer via stdin/stdout ved å bruke nd-JSON.

Flagg

Flagg	Beskrivelse
`--cwd`	Arbeidskatalog
`--port`	Port å lytte på
`--hostname`	Vertsnavn å lytte på

uninstall

Avinstaller Matrix og fjern alle relaterte filer.

matrix uninstall

Flagg

Flagg	Kort	Beskrivelse
`--keep-config`	`-c`	Behold konfigurasjonsfiler
`--keep-data`	`-d`	Behold øktdata og øyeblikksbilder
`--dry-run`		Vis hva som ville blitt fjernet uten å fjerne
`--force`	`-f`	Hopp over bekreftelsesforespørsler

upgrade

Oppdaterer Matrix til siste versjon eller en spesifikk versjon.

matrix upgrade [target]

For å oppgradere til siste versjon.

matrix upgrade

For å oppgradere til en bestemt versjon.

matrix upgrade v0.1.48

Flagg

Flagg	Kort	Beskrivelse
`--method`	`-m`	Installasjonsmetoden som ble brukt: curl, npm, pnpm, bun, brew

Globale flagg

Matrix CLI bruker følgende globale flagg.

Flagg	Kort	Beskrivelse
`--help`	`-h`	Vis hjelp
`--version`	`-v`	Skriv ut versjonsnummer
`--print-logs`		Skriv ut logger til stderr
`--log-level`		Loggnivå (DEBUG, INFO, WARN, ERROR)

Miljøvariabler

Matrix kan konfigureres ved hjelp av miljøvariabler.

Variabel	Type	Beskrivelse
`MATRIX_AUTO_SHARE`	boolsk	Del økter automatisk
`MATRIX_GIT_BASH_PATH`	streng	Bane til Git Bash-kjørbar på Windows
`MATRIX_CONFIG`	streng	Bane til konfigurasjonsfil
`MATRIX_TUI_CONFIG`	streng	Bane til TUI-konfigurasjonsfil
`MATRIX_CONFIG_DIR`	streng	Bane til konfigurasjonskatalog
`MATRIX_CONFIG_CONTENT`	streng	Innebygd json-konfigurasjonsinnhold
`MATRIX_DISABLE_AUTOUPDATE`	boolsk	Deaktiver automatiske oppdateringskontroller
`MATRIX_DISABLE_PRUNE`	boolsk	Deaktiver beskjæring av gamle data
`MATRIX_DISABLE_TERMINAL_TITLE`	boolsk	Deaktiver automatiske terminaltitteloppdateringer
`MATRIX_PERMISSION`	streng	Innebygd json-tillatelseskonfigurasjon
`MATRIX_DISABLE_DEFAULT_PLUGINS`	boolsk	Deaktiver standard plugins
`MATRIX_DISABLE_LSP_DOWNLOAD`	boolsk	Deaktiver automatiske LSP servernedlastinger
`MATRIX_ENABLE_EXPERIMENTAL_MODELS`	boolsk	Aktiver eksperimentelle modeller
`MATRIX_DISABLE_AUTOCOMPACT`	boolsk	Deaktiver automatisk kontekstkomprimering
`MATRIX_DISABLE_CLAUDE_CODE`	boolsk	Deaktiver lesing fra `.claude` (spørsmål + ferdigheter)
`MATRIX_DISABLE_CLAUDE_CODE_PROMPT`	boolsk	Deaktiver lesing `~/.claude/CLAUDE.md`
`MATRIX_DISABLE_CLAUDE_CODE_SKILLS`	boolsk	Deaktiver innlasting av `.claude/skills`
`MATRIX_DISABLE_MODELS_FETCH`	boolsk	Deaktiver henting av modeller fra eksterne kilder
`MATRIX_FAKE_VCS`	streng	Falsk VCS-leverandør for testformål
`MATRIX_DISABLE_FILETIME_CHECK`	boolsk	Deaktiver filtidskontroll for optimalisering
`MATRIX_CLIENT`	streng	Klientidentifikator (standard til `cli`)
`MATRIX_ENABLE_EXA`	boolsk	Aktiver Exa-nettsøkeverktøy
`MATRIX_SERVER_PASSWORD`	streng	Aktiver grunnleggende autentisering for `serve`/`web`
`MATRIX_SERVER_USERNAME`	streng	Overstyr grunnleggende autentiseringsbrukernavn (standard `matrix`)
`MATRIX_MODELS_URL`	streng	Egendefinert URL for henting av modellkonfigurasjon

Eksperimentelt

Disse miljøvariablene muliggjør eksperimentelle funksjoner som kan endres eller fjernes.

Variabel	Type	Beskrivelse
`MATRIX_EXPERIMENTAL`	boolsk	Aktiver alle eksperimentelle funksjoner
`MATRIX_EXPERIMENTAL_ICON_DISCOVERY`	boolsk	Aktiver ikonoppdagelse
`MATRIX_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolsk	Deaktiver kopi ved valg i TUI
`MATRIX_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	tall	Standard tidsavbrudd for bash-kommandoer i ms
`MATRIX_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	tall	Maks Output Tokens for LLM-svar
`MATRIX_EXPERIMENTAL_FILEWATCHER`	boolsk	Aktiver filovervåker for hele dir
`MATRIX_EXPERIMENTAL_OXFMT`	boolsk	Aktiver oxfmt formatter
`MATRIX_EXPERIMENTAL_LSP_TOOL`	boolsk	Aktiver eksperimentelt LSP-verktøy
`MATRIX_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolsk	Deaktiver filovervåking
`MATRIX_EXPERIMENTAL_EXA`	boolsk	Aktiver eksperimentelle Exa-funksjoner
`MATRIX_EXPERIMENTAL_LSP_TY`	boolsk	Aktiver TY LSP for python-filer
`MATRIX_EXPERIMENTAL_MARKDOWN`	boolsk	Aktiver eksperimentelle Markdown-funksjoner
`MATRIX_EXPERIMENTAL_PLAN_MODE`	boolsk	Aktiver planmodus