CLI

matrix CLI seçenekleri ve komutları.

matrix CLI herhangi bir argüman olmadan çalıştırıldığında varsayılan olarak TUI’yi başlatır.

matrix

Ancak bu sayfada belgelendiği gibi komutları da kabul eder. Bu, matrix ile programlı olarak etkileşim kurmanıza olanak tanır.

matrix run "Explain how closures work in JavaScript"

tui

matrix terminal kullanıcı arayüzünü başlatır.

matrix [project]

Bayraklar

Bayrak	Kısa	Açıklama
`--continue`	`-c`	Son oturuma devam et
`--session`	`-s`	Devam edecek oturum kimliği
`--fork`		Devam ederken oturumu fork’lar (`--continue` veya `--session` ile kullanın)
`--prompt`		Kullanılacak prompt
`--model`	`-m`	provider/model biçiminde kullanılacak model
`--agent`		Kullanılacak agent
`--port`		Dinlenecek port
`--hostname`		Dinlenecek host adı

Komutlar

matrix CLI ayrıca aşağıdaki komutlara da sahiptir.

agent

matrix için agent’ları yönetin.

matrix agent [command]

attach

serve veya web komutlarıyla başlatılan, halihazırda çalışan bir matrix arka uç sunucusuna bir terminal ekleyin.

matrix attach [url]

Bu, TUI öğesinin uzak bir matrix arka ucuyla kullanılmasına olanak tanır. Örneğin:

# 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

Bayraklar

Bayrak	Kısa	Tanım
`--dir`		TUI’yi başlatmak için çalışma dizini
`--session`	`-s`	Devam edecek oturum açma bilgileri

create

Özel yapılandırmaya sahip yeni bir agent oluşturun.

matrix agent create

Bu komut, özel sistem istemi ve araç yapılandırmasıyla yeni bir agent oluşturma konusunda size yol gösterecektir.

list

Mevcut tüm agent’ları listeleyin.

matrix agent list

auth

Sağlayıcılar için kimlik bilgilerini ve oturum açmayı yönetme komutu.

matrix auth [command]

matrix, Models.dev adresindeki sağlayıcı listesi tarafından desteklenmektedir, dolayısıyla kullanmak istediğiniz herhangi bir sağlayıcı için API anahtarlarını ayarlamak üzere matrix auth login kullanabilirsiniz. Bu ~/.local/share/matrix/auth.json’de saklanıyor.

matrix auth login

matrix başlatıldığında sağlayıcıları kimlik bilgileri dosyasından yükler. Ayrıca ortam değişkenlerindeki veya projenizdeki .env dosyasındaki anahtarları da kullanır.

list

Kimlik bilgileri dosyasında depolanan tüm kimliği doğrulanmış sağlayıcıları listeler.

matrix auth list

Veya kısa versiyonu.

matrix auth ls

logout

Bir sağlayıcıyı kimlik bilgileri dosyasından temizleyerek oturumunuzu kapatır.

matrix auth logout

github

Depo otomasyonu için GitHub aracısını yönetin.

matrix github [command]

install

GitHub aracısını deponuza yükleyin.

matrix github install

Bu komut gerekli GitHub Actions workflow’unu kurar ve yapılandırma adımlarında size rehberlik eder. Daha fazla bilgi.

run

GitHub aracısını çalıştırın. Bu genellikle GitHub Eylemlerinde kullanılır.

matrix github run

Bayraklar

Bayrak	Açıklama
`--event`	Aracıyı çalıştırmak için GitHub sahte olayı
`--token`	GitHub personal access token

mcp

Model Bağlam Protokolü sunucularını yönetin.

matrix mcp [command]

add

Yapılandırmanıza bir MCP sunucusu ekleyin.

matrix mcp add

Bu komut, yerel veya uzak bir MCP sunucusu ekleme konusunda size yol gösterecektir.

list

Yapılandırılmış tüm MCP sunucularını ve bağlantı durumlarını listeleyin.

matrix mcp list

Veya kısa versiyonunu kullanın.

matrix mcp ls

auth

OAuth’un etkin olduğu bir MCP sunucusuyla kimlik doğrulaması yapın.

matrix mcp auth [name]

Sunucu adı belirtmezseniz mevcut OAuth özellikli sunucular arasından seçim yapmanız istenir.

Ayrıca OAuth özellikli sunucuları ve bunların kimlik doğrulama durumlarını da listeleyebilirsiniz.

matrix mcp auth list

Veya kısa versiyonunu kullanın.

matrix mcp auth ls

logout

MCP sunucusu için OAuth kimlik bilgilerini kaldırın.

matrix mcp logout [name]

debug

MCP sunucusu için OAuth bağlantı sorunlarının hatalarını ayıklayın.

matrix mcp debug <name>

models

Yapılandırılmış sağlayıcıların tüm mevcut modellerini listeleyin.

matrix models [provider]

Bu komut, yapılandırdığınız sağlayıcılardaki modelleri provider/model formatında listeler.

Bu, config dosyanızda kullanmanız gereken tam model adını bulmak için kullanışlıdır.

Modelleri bu sağlayıcıya göre filtrelemek için isteğe bağlı olarak bir sağlayıcı kimliğini iletebilirsiniz.

matrix models anthropic

Bayraklar

Bayrak	Tanım
`--refresh`	Modeller.dev’den model önbelleğini yenileyin
`--verbose`	Daha ayrıntılı model çıktısı kullanın (maliyetler gibi meta veriler içerir)

Önbelleğe alınan model listesini güncellemek için --refresh bayrağını kullanın. Bu, bir sağlayıcıya yeni modeller eklendiğinde ve bunları matrix’da görmek istediğinizde kullanışlıdır.

matrix models --refresh

run

Doğrudan bir istem ileterek matrix’u etkileşimli olmayan modda çalıştırın.

matrix run [message..]

Bu, komut dosyası oluşturma, otomasyon veya TUI’un tamamını başlatmadan hızlı bir yanıt istediğinizde kullanışlıdır. Örneğin.

matrix run Explain the use of context in Go

Ayrıca, her çalıştırmada MCP sunucusunun soğuk önyükleme sürelerini önlemek için çalışan bir matrix serve örneğine de ekleyebilirsiniz:

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

Bayraklar

Bayrak	Kısa	Açıklama
`--command`		Çalıştırılacak komut, args için mesajı kullanın
`--continue`	`-c`	Son oturuma devam et
`--session`	`-s`	Devam edecek oturum kimliği
`--fork`		Devam ederken oturumu fork’lar (`--continue` veya `--session` ile kullanın)
`--share`		Oturumu paylaşın
`--model`	`-m`	provider/model biçiminde kullanılacak model
`--agent`		Kullanılacak temsilci
`--file`	`-f`	Mesaja eklenecek dosya(lar)
`--format`		Biçim: varsayılan (biçimlendirilmiş) veya json (ham JSON olayları)
`--title`		Oturumun başlığı (değer sağlanmazsa kısaltılmış bilgi istemi kullanılır)
`--attach`		Çalışan bir matrix sunucusuna ekleyin (ör. http://localhost:4096)
`--port`		Yerel sunucunun bağlantı noktası (varsayılan olarak rastgele bağlantı noktasıdır)

serve

API erişimi için headless bir matrix sunucusu başlatır. Tam HTTP arayüzü için server docs sayfasına bakın.

matrix serve

Bu, TUI arayüzü olmadan matrix işlevselliğine API erişimi sağlayan bir HTTP sunucusunu başlatır. HTTP temel kimlik doğrulamasını etkinleştirmek için MATRIX_SERVER_PASSWORD öğesini ayarlayın (kullanıcı adı varsayılan olarak matrix şeklindedir).

Bayraklar

Bayrak	Tanım
`--port`	Dinlenecek bağlantı noktası
`--hostname`	Dinlenecek ana bilgisayar adı
`--mdns`	mDNS bulmayı etkinleştir
`--cors`	CORS’a izin verecek ek tarayıcı kaynakları

session

matrix oturumlarını yönetin.

matrix session [command]

list

Tüm matrix oturumlarını listeleyin.

matrix session list

Bayraklar

Bayrak	Kısa	Tanım
`--max-count`	`-n`	En son N oturumla sınırla
`--format`		Çıkış formatı: tablo veya json (tablo)

stats

matrix oturumlarınız için belirteç kullanımı ve maliyet istatistiklerini gösterin.

matrix stats

Bayraklar

Bayrak	Açıklama
`--days`	Son N güne ait istatistikleri göster (tüm zamanlar)
`--tools`	Gösterilecek araç sayısı (tümü)
`--models`	Model kullanım dökümünü göster (varsayılan olarak gizlidir). En üstteki N’yi göstermek için bir sayı iletin
`--project`	Projeye göre filtrele (tüm projeler, boş değer: mevcut proje)

export

Oturum verilerini JSON olarak dışa aktarın.

matrix export [sessionID]

Bir oturum kimliği sağlamazsanız mevcut oturumlar arasından seçim yapmanız istenir.

import

Bir JSON dosyasından veya matrix paylaşımından URL oturum verilerini içe aktarın.

matrix import <file>

Yerel bir dosyadan veya matrix paylaşımından (URL) içe aktarabilirsiniz.

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

web

Web arayüzüyle başsız bir matrix sunucusu başlatın.

matrix web

Bu, bir HTTP sunucusunu başlatır ve bir web arayüzü aracılığıyla matrix’a erişmek için bir web tarayıcısı açar. HTTP temel kimlik doğrulamasını etkinleştirmek için MATRIX_SERVER_PASSWORD öğesini ayarlayın (kullanıcı adı varsayılan olarak matrix şeklindedir).

Bayraklar

Bayrak	Tanım
`--port`	Dinlenecek bağlantı noktası
`--hostname`	Dinlenecek ana bilgisayar adı
`--mdns`	mDNS bulmayı etkinleştir
`--cors`	CORS’a izin verecek ek tarayıcı kaynakları

acp

Bir ACP (Ajan İstemci Protokolü) sunucusu başlatın.

matrix acp

Bu komut, nd-JSON kullanarak stdin/stdout aracılığıyla iletişim kuran bir ACP sunucusunu başlatır.

Bayraklar

Bayrak	Açıklama
`--cwd`	Çalışma dizini
`--port`	Dinlenecek port
`--hostname`	Dinlenecek host adı

uninstall

matrix’u kaldırın ve ilgili tüm dosyaları kaldırın.

matrix uninstall

Bayraklar

Bayrak	Kısa	Tanım
`--keep-config`	`-c`	Yapılandırma dosyalarını sakla
`--keep-data`	`-d`	Oturum verilerini ve anlık görüntüleri saklayın
`--dry-run`		Nelerin kaldırılmadan kaldırılacağı göster
`--force`	`-f`	Onay istemlerini atla

upgrade

matrix’u en son sürüme veya belirli bir sürüme günceller.

matrix upgrade [target]

En son sürüme yükseltmek için.

matrix upgrade

Belirli bir sürüme yükseltmek için:

matrix upgrade v0.1.48

Bayraklar

Bayrak	Kısa	Açıklama
`--method`	`-m`	Kullanılan kurulum yöntemi: curl, npm, pnpm, bun, brew

Global bayraklar

matrix CLI aşağıdaki global bayrakları destekler.

Bayrak	Kısa	Tanım
`--help`	`-h`	Yardımı görüntüle
`--version`	`-v`	Sürüm numarasını yazdır
`--print-logs`		Günlükleri stderr’e yazdır
`--log-level`		Günlük düzeyi (DEBUG, INFO, WARN, ERROR)

Ortam değişkenleri

matrix ortam değişkenleri kullanılarak yapılandırılabilir.

Değişken	Tip	Açıklama
`MATRIX_AUTO_SHARE`	boolean	Oturumları otomatik olarak paylaş
`MATRIX_GIT_BASH_PATH`	string	Windows’ta yürütülebilir Git Bash’in Yolu
`MATRIX_CONFIG`	string	Yapılandırma dosyasının yolu
`MATRIX_TUI_CONFIG`	string	TUI yapılandırma dosyasının yolu
`MATRIX_CONFIG_DIR`	string	Yapılandırma dizinine giden yol
`MATRIX_CONFIG_CONTENT`	string	Satır içi JSON config içeriği
`MATRIX_DISABLE_AUTOUPDATE`	boolean	Otomatik güncelleme kontrollerini devre dışı bırak
`MATRIX_DISABLE_PRUNE`	boolean	Eski verilerin temizlenmesini devre dışı bırak
`MATRIX_DISABLE_TERMINAL_TITLE`	boolean	Otomatik terminal başlığı güncellemelerini devre dışı bırakın
`MATRIX_PERMISSION`	string	Satır içi JSON izin config’i
`MATRIX_DISABLE_DEFAULT_PLUGINS`	boolean	Varsayılan eklentileri devre dışı bırakın
`MATRIX_DISABLE_LSP_DOWNLOAD`	boolean	Otomatik LSP sunucu indirmelerini devre dışı bırakın
`MATRIX_ENABLE_EXPERIMENTAL_MODELS`	boolean	Deneysel modelleri etkinleştir
`MATRIX_DISABLE_AUTOCOMPACT`	boolean	Otomatik context sıkıştırmayı devre dışı bırak
`MATRIX_DISABLE_CLAUDE_CODE`	boolean	`.claude`’den okumayı devre dışı bırak (istem + beceriler)
`MATRIX_DISABLE_CLAUDE_CODE_PROMPT`	boolean	`~/.claude/CLAUDE.md` dosyasını okumayı devre dışı bırak
`MATRIX_DISABLE_CLAUDE_CODE_SKILLS`	boolean	`.claude/skills` yüklemesini devre dışı bırak
`MATRIX_DISABLE_MODELS_FETCH`	boolean	Uzak kaynaklardan model getirmeyi devre dışı bırakın
`MATRIX_FAKE_VCS`	string	Test amaçlı sahte VCS sağlayıcısı
`MATRIX_DISABLE_FILETIME_CHECK`	boolean	Optimizasyon için dosya süresi kontrolünü devre dışı bırakın
`MATRIX_CLIENT`	string	Client kimliği (varsayılan: `cli`)
`MATRIX_ENABLE_EXA`	boolean	Exa web arama araçlarını etkinleştir
`MATRIX_SERVER_PASSWORD`	string	`serve`/`web` için temel kimlik doğrulamayı etkinleştirin
`MATRIX_SERVER_USERNAME`	string	Temel kimlik doğrulama kullanıcı adını geçersiz kıl (varsayılan `matrix`)
`MATRIX_MODELS_URL`	string	Model yapılandırmasını almak için özel URL

Deneysel

Bu ortam değişkenleri değişebilecek veya kaldırılabilecek deneysel özellikleri etkinleştirir.

Değişken	Tip	Tanım
`MATRIX_EXPERIMENTAL`	boolean	Tüm deneysel özellikleri etkinleştir
`MATRIX_EXPERIMENTAL_ICON_DISCOVERY`	boolean	Simge bulmayı etkinleştir
`MATRIX_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolean	TUI’da seçim yapıldığında kopyalamayı devre dışı bırak
`MATRIX_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	number	MS cinsinden bash komutları için varsayılan zaman aşımı
`MATRIX_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	number	LLM yanıtları için maksimum çıktı belirteçleri
`MATRIX_EXPERIMENTAL_FILEWATCHER`	boolean	Tüm dizin için dosya izleyiciyi etkinleştir
`MATRIX_EXPERIMENTAL_OXFMT`	boolean	Oxfmt biçimlendiriciyi etkinleştir
`MATRIX_EXPERIMENTAL_LSP_TOOL`	boolean	Deneysel LSP aracını etkinleştir
`MATRIX_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolean	Dosya izleyiciyi devre dışı bırak
`MATRIX_EXPERIMENTAL_EXA`	boolean	Deneysel Exa özelliklerini etkinleştirin
`MATRIX_EXPERIMENTAL_LSP_TY`	boolean	python dosyaları için TY LSP’yi etkinleştir
`MATRIX_EXPERIMENTAL_MARKDOWN`	boolean	Deneysel işaretleme özelliklerini etkinleştir
`MATRIX_EXPERIMENTAL_PLAN_MODE`	boolean	Plan modunu etkinleştir