Konfigurasi

Konfigurasi

Kamu dapat mengkonfigurasi Bob Shell agar sesuai dengan preferensi alur kerjamu.

Lokasi file pengaturan

Bob Shell menyimpan pengaturan di dua lokasi:

CakupanFile
Pengguna (semua workspace)~/.bob/settings/settings.json
Proyek (workspace saat ini)<workspace>/.bob/

Flag CLI selalu menggantikan nilai file untuk sesi saat ini. Kamu juga dapat mengubah pengaturan secara interaktif melalui perintah slash /settings di dalam bob chat.

Skema pengaturan

{
  "session": {
    "maxTurns": 50,
    "defaultMode": "agent",
    "mcp": true,
    "subagents": true
  },
  "logging": {
    "logLevel": "warn"
  },
  "tasks": {
    "retentionDays": 30
  },
  "telemetry": {
    "enabled": true
  }
}
PengaturanTipeDefaultDeskripsi
session.maxTurnsnumber50Maksimum giliran agentik per sesi (0 = tidak terbatas)
session.defaultModestring"agent"Mode default saat memulai sesi
session.mcpbooleantrueAktifkan server Model Context Protocol (MCP) secara default
session.subagentsbooleantrueAktifkan pembuatan subagent secara default
logging.logLevelstring"warn"Verbositas log (error, warn, info, debug, trace)
tasks.retentionDaysnumber30Jumlah hari untuk menyimpan riwayat task. Atur ke 0 untuk menonaktifkan pembersihan otomatis dan menyimpan semua riwayat task.
telemetry.enabledbooleantrueApakah telemetri penggunaan dikirim. Menonaktifkan mencegah pengumpulan data penggunaan.
telemetry.excludePayloadbooleanPengguna IBM: kecualikan payload percakapan dari telemetri. Hanya aktifkan untuk proyek sensitif yang disetujui.
Warning:

Hanya atur tasks.retentionDays ke 0 di Bob Shell 2.0.1 atau yang lebih baru. Mengatur nilai ini ke 0 di versi sebelumnya dapat menghapus task yang tidak di-pin dan riwayatnya.

Token autentikasi (OAuth) disimpan secara terpisah di ~/.bob/settings/auth-secrets.json.

File log

Log ditulis ke ~/.bob/logs/shell/ menggunakan file berputar (bob-<timestamp>.log). Hingga 10 file log disimpan; file yang lebih lama dipangkas secara otomatis. Ukuran file log maksimum adalah 5 MB sebelum rotasi.

Gunakan --log-level debug (atau BOB_LOG_LEVEL=debug) untuk menangkap output verbose:

BOB_LOG_LEVEL=debug bob chat
bob run --log-level debug "Explain @app.js"

Kamu juga dapat membuka file log terbaru langsung dari dalam sesi menggunakan perintah slash /logs.

File konteks

File konteks (seperti AGENTS.md) memberikan instruksi ke model AI. File-file ini dimuat secara hierarkis:

  1. Konteks global: ~/.bob/AGENTS.md (berlaku untuk semua proyek)
  2. Konteks proyek: AGENTS.md di root proyek dan direktori induk
  3. Konteks lokal: AGENTS.md di subdirektori (untuk instruksi spesifik komponen)

Contoh file konteks

# Project: My TypeScript Library

## General instructions

- Follow existing coding style
- Add JSDoc comments to all functions
- Prefer functional programming patterns
- Target TypeScript 5.0 and Node.js 20+

## Coding style

- Use 2 spaces for indentation
- Interface names should be prefixed with `I`
- Private class members should be prefixed with `_`
- Use strict equality (`===` and `!==`)

Statistik penggunaan

Bob Shell mengumpulkan statistik penggunaan anonim untuk meningkatkan produk. Ini termasuk:

  • Pola penggunaan tool (nama, sukses/gagal, durasi)
  • Metrik permintaan API (model, durasi, sukses)
  • Informasi konfigurasi sesi

Tidak ada informasi pribadi, konten prompt, atau konten file yang dikumpulkan.

Untuk keluar, atur telemetry.enabled ke false di file pengaturanmu:

{
  "telemetry": {
    "enabled": false
  }
}
Bagaimana topik ini?