İçeriğe geç
V1 dokümanları
Dosya referansları

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.

Terminal
opencode

İsterseniz belirli bir çalışma dizini için de başlatabilirsiniz.

Terminal
opencode /path/to/project

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

Terminal
!ls -la

Komut çı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:

Terminal
/help

Komutları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.

Terminal
/connect

Mevcut oturumu sıkıştırır. Takma ad: /summarize

Terminal
/compact

Kı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.

Terminal
/editor

Kısayol: ctrl+x e


OpenCode’dan çıkar. Takma adlar: /quit, /q

Terminal
/exit

Kı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.

Terminal
/export

Kısayol: ctrl+x x


Yardım penceresini gösterir.

Terminal
/help

Kısayol: ctrl+x h


AGENTS.md dosyasını oluşturur veya günceller. Daha fazla bilgi.

Terminal
/init

Kısayol: ctrl+x i


Kullanılabilir modelleri listeler.

Terminal
/models

Kısayol: ctrl+x m


Yeni bir oturum başlatır. Takma ad: /clear

Terminal
/new

Kı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.

Terminal
/redo

Kısayol: ctrl+x r


Oturumları listeler ve aralarında geçiş yapar. Takma adlar: /resume, /continue

Terminal
/sessions

Kısayol: ctrl+x l


Kullanılabilir temaları listeler.

Terminal
/themes

Kı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.

Terminal
/thinking

Konuş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.

Terminal
/undo

Kısayol: ctrl+x u


Hem /editor hem de /export komutları, EDITOR ortam değişkeninde belirtilen editörü kullanır.

Terminal
# 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.

Popüler editör seçenekleri şunları içerir:

  • code - Visual Studio Code
  • cursor - Cursor
  • windsurf - Windsurf
  • nvim - Neovim editörü
  • vim - Vim editörü
  • nano - Nano editörü
  • notepad - Windows Notepad
  • subl - 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.

tui.json
{
  "$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ğer 2000.
  • 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 ayar scroll_speed ayarı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ğer 3’tür. Not: scroll_acceleration.enabled true olarak 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ğer false.
  • notifications - Attention etkin olduğunda TUI’nin terminal üzerinden masaüstü bildirimi göndermesine izin verir. Varsayılan değer true.
  • sound - Attention etkin olduğunda uyarı seslerinin çalmasına izin verir. Varsayılan değer true.
  • volume - Uyarı sesleri için varsayılan ses düzeyi, 0 ile 1 arasındadır. Varsayılan değer 0.4.
  • sound_pack - Kullanılacak sound pack ID. Varsayılan değer opencode.default.
  • sounds - default, question, permission, error, done veya subagent_done için özel ses dosyaları ayarlar. Yollar mutlak, file:// URL’leri veya tui.json dosyası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