CLI

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

opencode

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

codetutor run "Explain how closures work in JavaScript"

---

tui

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

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

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

---

agent

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

codetutor agent [command]

---

attach

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

codetutor attach [url]

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

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

# In another terminal, attach the TUI to the running backend
codetutor attach http://10.20.30.40:4096

Bayraklar

Bayrak	Kısa	Tanım
--dir		TUI’yi başlatmak için çalışma dizini
--continue	-c	Son oturuma devam et
--session	-s	Devam edecek oturum açma bilgileri
--fork		Devam ederken oturumu çatalla (--continue veya --session ile kullanın)
--password	-p	Temel kimlik doğrulama parolası (varsayılan: CODETUTOR_SERVER_PASSWORD)
--username	-u	Temel kimlik doğrulama kullanıcı adı (varsayılan: CODETUTOR_SERVER_USERNAME veya codetutor)

---

create

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

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

codetutor agent list

---

auth

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

codetutor auth [command]

---

login

opencode, 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 codetutor auth login kullanabilirsiniz. Bu ~/.local/share/opencode/auth.json’de saklanıyor.

codetutor auth login

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

codetutor auth list

Veya kısa versiyonu.

codetutor auth ls

---

logout

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

codetutor auth logout

---

github

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

codetutor github [command]

---

install

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

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

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

codetutor mcp [command]

---

add

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

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

codetutor mcp list

Veya kısa versiyonunu kullanın.

codetutor mcp ls

---

auth

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

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

codetutor mcp auth list

Veya kısa versiyonunu kullanın.

codetutor mcp auth ls

---

logout

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

codetutor mcp logout [name]

---

debug

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

codetutor mcp debug <name>

---

models

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

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

codetutor 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ı opencode’da görmek istediğinizde kullanışlıdır.

codetutor models --refresh

---

run

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

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

codetutor 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 codetutor serve örneğine de ekleyebilirsiniz:

# Start a headless server in one terminal
codetutor serve

# In another terminal, run commands that attach to it
codetutor 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 codetutor sunucusuna ekleyin (ör. http://localhost:4096)
--password	-p	Temel kimlik doğrulama parolası (varsayılan: CODETUTOR_SERVER_PASSWORD)
--username	-u	Temel kimlik doğrulama kullanıcı adı (varsayılan: CODETUTOR_SERVER_USERNAME veya codetutor)
--dir		Çalıştırılacak dizin veya bağlanırken uzak sunucudaki yol
--variant		Model varyantı (sağlayıcıya özgü muhakeme düzeyi)
--thinking		Düşünme bloklarını göster
--port		Yerel sunucunun bağlantı noktası (varsayılan olarak rastgele bağlantı noktasıdır)

---

serve

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

codetutor serve

Bu, TUI arayüzü olmadan codetutor işlevselliğine API erişimi sağlayan bir HTTP sunucusunu başlatır. HTTP temel kimlik doğrulamasını etkinleştirmek için CODETUTOR_SERVER_PASSWORD öğesini ayarlayın (kullanıcı adı varsayılan olarak codetutor ş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

codetutor oturumlarını yönetin.

codetutor session [command]

---

list

Tüm codetutor oturumlarını listeleyin.

codetutor 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

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

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

codetutor export [sessionID]

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

---

import

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

codetutor import <file>

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

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

---

web

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

codetutor web

Bu, bir HTTP sunucusunu başlatır ve bir web arayüzü aracılığıyla opencode’a erişmek için bir web tarayıcısı açar. HTTP temel kimlik doğrulamasını etkinleştirmek için CODETUTOR_SERVER_PASSWORD öğesini ayarlayın (kullanıcı adı varsayılan olarak codetutor ş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.

codetutor 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

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

codetutor 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

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

codetutor upgrade [target]

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

codetutor upgrade

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

codetutor upgrade v0.1.48

Bayraklar

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

---

Global bayraklar

opencode 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

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

Değişken	Tip	Açıklama
CODETUTOR_AUTO_SHARE	boolean	Oturumları otomatik olarak paylaş
CODETUTOR_GIT_BASH_PATH	string	Windows’ta yürütülebilir Git Bash’in Yolu
CODETUTOR_CONFIG	string	Yapılandırma dosyasının yolu
CODETUTOR_TUI_CONFIG	string	TUI yapılandırma dosyasının yolu
CODETUTOR_CONFIG_DIR	string	Yapılandırma dizinine giden yol
CODETUTOR_CONFIG_CONTENT	string	Satır içi JSON config içeriği
CODETUTOR_DISABLE_AUTOUPDATE	boolean	Otomatik güncelleme kontrollerini devre dışı bırak
CODETUTOR_DISABLE_PRUNE	boolean	Eski verilerin temizlenmesini devre dışı bırak
CODETUTOR_DISABLE_TERMINAL_TITLE	boolean	Otomatik terminal başlığı güncellemelerini devre dışı bırakın
CODETUTOR_PERMISSION	string	Satır içi JSON izin config’i
CODETUTOR_DISABLE_DEFAULT_PLUGINS	boolean	Varsayılan eklentileri devre dışı bırakın
CODETUTOR_DISABLE_LSP_DOWNLOAD	boolean	Otomatik LSP sunucu indirmelerini devre dışı bırakın
CODETUTOR_ENABLE_EXPERIMENTAL_MODELS	boolean	Deneysel modelleri etkinleştir
CODETUTOR_DISABLE_AUTOCOMPACT	boolean	Otomatik context sıkıştırmayı devre dışı bırak
CODETUTOR_DISABLE_CLAUDE_CODE	boolean	.claude’den okumayı devre dışı bırak (istem + beceriler)
CODETUTOR_DISABLE_CLAUDE_CODE_PROMPT	boolean	~/.claude/CLAUDE.md dosyasını okumayı devre dışı bırak
CODETUTOR_DISABLE_CLAUDE_CODE_SKILLS	boolean	.claude/skills yüklemesini devre dışı bırak
CODETUTOR_DISABLE_MODELS_FETCH	boolean	Uzak kaynaklardan model getirmeyi devre dışı bırakın
CODETUTOR_FAKE_VCS	string	Test amaçlı sahte VCS sağlayıcısı
CODETUTOR_CLIENT	string	Client kimliği (varsayılan: cli)
CODETUTOR_ENABLE_EXA	boolean	Exa web arama araçlarını etkinleştir
CODETUTOR_SERVER_PASSWORD	string	serve/web için temel kimlik doğrulamayı etkinleştirin
CODETUTOR_SERVER_USERNAME	string	Temel kimlik doğrulama kullanıcı adını geçersiz kıl (varsayılan codetutor)
CODETUTOR_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
CODETUTOR_EXPERIMENTAL	boolean	Şemsiye bayrağa bağlı deneysel özellikleri etkinleştir
CODETUTOR_EXPERIMENTAL_ICON_DISCOVERY	boolean	Simge bulmayı etkinleştir
CODETUTOR_EXPERIMENTAL_DISABLE_COPY_ON_SELECT	boolean	TUI’da seçim yapıldığında kopyalamayı devre dışı bırak
CODETUTOR_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS	number	MS cinsinden bash komutları için varsayılan zaman aşımı
CODETUTOR_EXPERIMENTAL_OUTPUT_TOKEN_MAX	number	LLM yanıtları için maksimum çıktı belirteçleri
CODETUTOR_EXPERIMENTAL_FILEWATCHER	boolean	Tüm dizin için dosya izleyiciyi etkinleştir
CODETUTOR_EXPERIMENTAL_OXFMT	boolean	Oxfmt biçimlendiriciyi etkinleştir
CODETUTOR_EXPERIMENTAL_LSP_TOOL	boolean	Deneysel LSP aracını etkinleştir
CODETUTOR_EXPERIMENTAL_DISABLE_FILEWATCHER	boolean	Dosya izleyiciyi devre dışı bırak
CODETUTOR_EXPERIMENTAL_EXA	boolean	Deneysel Exa özelliklerini etkinleştirin
CODETUTOR_EXPERIMENTAL_LSP_TY	boolean	python dosyaları için TY LSP’yi etkinleştir
CODETUTOR_EXPERIMENTAL_PLAN_MODE	boolean	Plan modunu etkinleştir
CODETUTOR_EXPERIMENTAL_BACKGROUND_SUBAGENTS	boolean	Arka plan alt ajan görevlerini etkinleştir
CODETUTOR_EXPERIMENTAL_EVENT_SYSTEM	boolean	Deneysel olay sistemini etkinleştir
CODETUTOR_EXPERIMENTAL_NATIVE_LLM	boolean	Yerel LLM istek yolunu etkinleştir
CODETUTOR_EXPERIMENTAL_PARALLEL	boolean	Paralel web araması yürütmesini etkinleştir
CODETUTOR_EXPERIMENTAL_SCOUT	boolean	Scout alt ajanını etkinleştir
CODETUTOR_EXPERIMENTAL_WORKSPACES	boolean	Çalışma alanı desteğini etkinleştir