Selesai menyimpan pengaturan sebagai JSON di dua file: ~/.selesai/agent/settings.json (global, berlaku untuk semua proyek) dan .selesai/settings.json (proyek, menimpa global untuk direktori saat ini). Edit file secara langsung, atau jalankan /settings di dalam sesi untuk mengubah opsi umum secara interaktif.
Halaman ini mencakup pengaturan yang paling sering disentuh orang. Referensi lengkap ada di docs/settings.md di GitHub, dan opsi per ekstensi ada di halaman Kustomisasi.
Model
Pengaturan
Tipe
Default
Fungsinya
defaultProvider
string
—
Provider default, mis. "anthropic" atau "openai".
defaultModel
string
—
ID model default untuk sesi baru.
defaultThinkingLevel
string
—
Seberapa banyak agent berpikir sebelum menjawab: "off", "minimal", "low", "medium", "high", atau "xhigh".
enabledModels
string[]
—
Pola model untuk perpindahan Ctrl+P, mis. ["claude-*"].
Tool
Pengaturan
Tipe
Default
Fungsinya
defaultTools
string[]
—
Pemilihan tool bawaan awal untuk sesi baru. Saat disetel, sesi baru hanya mengaktifkan tool ini (berguna bersama SDK); saat dihilangkan, read, bash, edit, write default dipakai.
Tampilan
Pengaturan
Tipe
Default
Fungsinya
theme
string
"dark"
"dark", "light", atau nama tema kustom. Anda juga bisa mengatur tema awal untuk satu sesi dengan --use-theme <nama>.
quietStartup
boolean
false
Sembunyikan bantuan keybinding dan daftar resource yang dimuat agar peluncuran lebih tenang. Banner brand selalu tampil dan menghilang pada pesan pertama Anda.
tuiMode
string
"fullscreen"
"fullscreen" (tata letak dock default) atau "regular" (tata letak Pi klasik).
fullscreenExitOutput
string
"transcript"
Yang terjadi saat keluar dari fullscreen: mencetak transkrip ("transcript") atau hanya petunjuk resume sesi ("resume-hint").
fullscreenCopyOnSelect
boolean
true
Menyalin teks terpilih secara otomatis di mode fullscreen; nonaktifkan untuk menyalin seleksi dengan Ctrl+X.
Konteks
Pengaturan
Tipe
Default
Fungsinya
compaction.enabled
boolean
true
Kompakkan otomatis konteks lama saat percakapan membesar.
compaction.reserveTokens
number
16384
Token yang disisakan untuk balasan model.
compaction.keepRecentTokens
number
20000
Token terbaru yang tidak pernah diringkas.
Kepercayaan dan keamanan
Pengaturan
Tipe
Default
Fungsinya
defaultProjectTrust
string
"ask"
Fallback untuk mempercayai proyek pada run non-interaktif: "ask", "always", atau "never". Hanya pengaturan global.
Ekstensibilitas
Pengaturan
Tipe
Default
Fungsinya
packages
array
[]
Package npm/git yang memuat ekstensi, skill, prompt, dan tema.
extensions
string[]
[]
File atau direktori ekstensi lokal yang dimuat.
skills
string[]
[]
File atau direktori skill tambahan, atau pola eksplisit +/-. Penemuan normal otomatis memuat skill dari ~/.selesai/agent/skills/, ~/.agents/skills/, .selesai/skills/, dan direktori .agents/skills/ project/ancestor, sehingga pengaturan ini tidak wajib untuk skill biasa.
Tempat pengaturan berada
Lokasi
Cakupan
~/.selesai/agent/settings.json
Global — berlaku untuk semua proyek.
.selesai/settings.json
Proyek — menimpa nilai global untuk direktori saat ini.
Objek bersarang digabungkan, sehingga file proyek hanya perlu menimpa kunci yang diinginkan.
Reset pabrik
Untuk mengembalikan pengaturan global ke default pabrik bawaan, jalankan /settings-factory-reset di dalam sesi. Perintah ini memberi peringatan sebelum mengganti ~/.selesai/agent/settings.json, menyimpan cadangan .bak di samping file, dan tidak menyentuh kredensial (auth.json), sesi, ekstensi, skill, maupun tema.
