TUI
OpenCode, projelerinizde LLM ile çalışmak için etkileşimli bir terminal arayüzü (TUI) sunar.
OpenCode’u çalıştırdığınızda mevcut dizin için TUI başlar.
opencodeİsterseniz belirli bir çalışma dizini için de başlatabilirsiniz.
opencode /path/to/projectTUI içine girdiğinizde, bir mesajla istem gönderebilirsiniz.
Give me a quick summary of the codebase.Mesajlarınızda @ kullanarak dosyalara referans verebilirsiniz. Bu, mevcut çalışma dizininde bulanık dosya araması yapar.
How is auth handled in @packages/functions/src/api/index.ts?Dosya içeriği otomatik olarak konuşmaya eklenir.
Bir mesajı ! ile başlatarak shell komutu çalıştırın.
!ls -laKomut çıktısı bir araç sonucu olarak konuşmaya eklenir.
OpenCode TUI kullanırken / ve ardından komut adını yazarak hızlı eylemler çalıştırabilirsiniz. Örneğin:
/helpKomutların çoğu, lider tuşu ctrl+x olan bir kısayola da sahiptir. Daha fazla bilgi.
İşte mevcut slash komutlarının tümü:
OpenCode’a bir sağlayıcı ekler. Mevcut sağlayıcıları seçip API anahtarları eklemenizi sağlar.
/connectMevcut oturumu sıkıştırır. Takma ad: /summarize
/compactKısayol: ctrl+x c
Mesaj yazmak için harici editör açar. EDITOR ortam değişkeninde ayarlı editörü kullanır. Daha fazla bilgi.
/editorKısayol: ctrl+x e
OpenCode’dan çıkar. Takma adlar: /quit, /q
/exitKısayol: ctrl+x q
Mevcut konuşmayı Markdown olarak dışa aktarır ve varsayılan editörünüzde açar. EDITOR ortam değişkeninde ayarlı editörü kullanır. Daha fazla bilgi.
/exportKısayol: ctrl+x x
Yardım penceresini gösterir.
/helpKısayol: ctrl+x h
AGENTS.md dosyasını oluşturur veya günceller. Daha fazla bilgi.
/initKısayol: ctrl+x i
Kullanılabilir modelleri listeler.
/modelsKısayol: ctrl+x m
Yeni bir oturum başlatır. Takma ad: /clear
/newKısayol: ctrl+x n
Geri alınan bir mesajı tekrar uygular. Yalnızca /undo kullanıldıktan sonra kullanılabilir.
Dahili olarak bu işlem dosya değişikliklerini yönetmek için Git kullanır. Bu nedenle projenizin bir Git deposu olması gerekir.
/redoKısayol: ctrl+x r
Oturumları listeler ve aralarında geçiş yapar. Takma adlar: /resume, /continue
/sessionsKısayol: ctrl+x l
Kullanılabilir temaları listeler.
/themesKısayol: ctrl+x t
Konuşmadaki thinking/reasoning bloklarının görünürlüğünü değiştirir. Etkin olduğunda, genişletilmiş düşünmeyi destekleyen modellerin akıl yürütme sürecini görebilirsiniz.
/thinkingKonuşmadaki son mesajı geri alır. En son kullanıcı mesajını, sonraki tüm yanıtları ve dosya değişikliklerini kaldırır.
Dahili olarak bu işlem dosya değişikliklerini yönetmek için Git kullanır. Bu nedenle projenizin bir Git deposu olması gerekir.
/undoKısayol: ctrl+x u
Hem /editor hem de /export komutları, EDITOR ortam değişkeninde belirtilen editörü kullanır.
# Example for nano or vim
export EDITOR=nano
export EDITOR=vim
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
export EDITOR="code --wait"Kalıcı yapmak için bunu kabuk profilinize ekleyin;
~/.bashrc, ~/.zshrc vb.
set EDITOR=notepad
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
set EDITOR=code --waitKalıcı yapmak için System Properties > Environment Variables yolunu kullanın.
$env:EDITOR = "notepad"
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
$env:EDITOR = "code --wait"Kalıcı yapmak için bunu PowerShell profilinize ekleyin.
Popüler editör seçenekleri şunları içerir:
code- Visual Studio Codecursor- Cursorwindsurf- Windsurfnvim- Neovim editörüvim- Vim editörünano- Nano editörünotepad- Windows Notepadsubl- Sublime Text
Bazı editörler bloklama modunda çalışmak için komut satırı argümanlarına ihtiyaç duyar. --wait bayrağı, editör süreci kapanana kadar işlemin bloklanmasını sağlar.
TUI davranışını tui.json (veya tui.jsonc) aracılığıyla özelleştirebilirsiniz.
{
"$schema": "https://opencode.ai/tui.json",
"theme": "opencode",
"leader_timeout": 2000,
"keybinds": {
"leader": "ctrl+x",
"command_list": "ctrl+p"
},
"scroll_speed": 3,
"scroll_acceleration": {
"enabled": false
},
"diff_style": "auto",
"mouse": true,
"attention": {
"enabled": true,
"notifications": true,
"sound": true,
"volume": 0.4,
"sound_pack": "opencode.default",
"sounds": {
"error": "./sounds/error.mp3"
}
}
}Bu, sunucu/çalışma zamanı davranışını yapılandıran opencode.json dosyasından ayrıdır.
keybinds yerleşik varsayılanlarla birleştirilir; bu yüzden yalnızca değiştirmek istediğiniz kısayolları yapılandırmanız yeterlidir.
theme- UI temanızı ayarlar. Daha fazla bilgi.keybinds- Klavye kısayollarını özelleştirir. Daha fazla bilgi.leader_timeout- OpenCode’un leader key sonrasında ne kadar bekleyeceğini kontrol eder. Varsayılan değer2000.scroll_acceleration.enabled- Pürüzsüz, doğal kaydırma için macOS tarzı kaydırma ivmesini etkinleştirin. Etkinleştirildiğinde, kaydırma hızı hızlı kaydırma hareketleriyle artar ve daha yavaş hareketler için hassas kalır. Bu ayarscroll_speedayarından önceliklidir ve etkinleştirildiğinde onu geçersiz kılar.scroll_speed- Kaydırma komutlarını kullanırken TUI’nin ne kadar hızlı kaydırılacağını kontrol eder (minimum:0.001, ondalık değerleri destekler). Varsayılan değer3’tür. Not:scroll_acceleration.enabledtrueolarak ayarlanmışsa bu yok sayılır.diff_style- Fark (diff) oluşturmayı kontrol eder."auto"terminal genişliğine uyum sağlar,"stacked"her zaman tek sütunlu bir düzen gösterir.mouse- TUI içinde fare yakalamayı etkinleştirir veya devre dışı bırakır (varsayılan:true). Devre dışı bırakıldığında terminalin yerel fareyle seçme ve kaydırma davranışı korunur.attention- TUI masaüstü bildirimlerini ve seslerini yapılandırır. Varsayılan olarak devre dışıdır.
Özel bir TUI yapılandırma yolu yüklemek için OPENCODE_TUI_CONFIG kullanın.
Attention, OpenCode bir yanıt beklediğinde, izin onayı gerektiğinde, oturum hatası oluştuğunda veya oturum tamamlandığında TUI’nin sizi ses ve masaüstü bildirimiyle uyarmasını sağlar. attention.enabled ile etkinleştirin; yerleşik olaylar gerçekleştiğinde ses çalar. Masaüstü bildirimleri yalnızca terminal penceresi odakta değilken gönderilir ve subagent olayları için kullanılmaz.
enabled- Attention için tüm bildirimleri ve sesleri etkinleştirir. Varsayılan değerfalse.notifications- Attention etkin olduğunda TUI’nin terminal üzerinden masaüstü bildirimi göndermesine izin verir. Varsayılan değertrue.sound- Attention etkin olduğunda uyarı seslerinin çalmasına izin verir. Varsayılan değertrue.volume- Uyarı sesleri için varsayılan ses düzeyi,0ile1arasındadır. Varsayılan değer0.4.sound_pack- Kullanılacak sound pack ID. Varsayılan değeropencode.default.sounds-default,question,permission,error,doneveyasubagent_doneiçin özel ses dosyaları ayarlar. Yollar mutlak,file://URL’leri veyatui.jsondosyasına göre göreli olabilir.
Komut paletini (ctrl+x h veya /help) kullanarak TUI görünümünün çeşitli yönlerini özelleştirebilirsiniz. Bu ayarlar yeniden başlatmalar arasında korunur.
Kullanıcı adı görünümü
Sohbet mesajlarında kullanıcı adınızın görünüp görünmeyeceğini değiştirin. Buna şuradan erişin:
- Komut paleti: “username” veya “hide username” araması yapın
- Ayar otomatik olarak kalıcı hale gelir ve TUI oturumları arasında hatırlanır