Speicherorte der Einstellungsdatei

Bob Shell speichert Einstellungen an zwei Orten:

Bereich	Datei
Nutzer (alle Workspaces)	`~/.bob/settings/settings.json`
Projekt (aktueller Workspace)	`<workspace>/.bob/`

CLI-Flags überschreiben immer die Dateiwerte für die aktuelle Sitzung. Du kannst Einstellungen auch interaktiv über den /settings-Slash-Befehl innerhalb von bob chat ändern.

Einstellungsschema

{
  "session": {
    "maxTurns": 50,
    "defaultMode": "agent",
    "mcp": true,
    "subagents": true
  },
  "logging": {
    "logLevel": "warn"
  },
  "tasks": {
    "retentionDays": 30
  },
  "telemetry": {
    "enabled": true
  }
}

Einstellung	Typ	Standard	Beschreibung
`session.maxTurns`	number	`50`	Maximale agentische Runden pro Sitzung (`0` = unbegrenzt)
`session.defaultMode`	string	`"agent"`	Standardmodus beim Start einer Sitzung
`session.mcp`	boolean	`true`	Model Context Protocol (MCP)-Server standardmäßig aktivieren
`session.subagents`	boolean	`true`	Subagenten-Erzeugung standardmäßig aktivieren
`logging.logLevel`	string	`"warn"`	Protokoll-Ausführlichkeit (`error`, `warn`, `info`, `debug`, `trace`)
`tasks.retentionDays`	number	`30`	Anzahl der Tage zur Aufbewahrung des Aufgabenverlaufs. Setze den Wert auf `0`, um die automatische Bereinigung zu deaktivieren und den gesamten Aufgabenverlauf beizubehalten.
`telemetry.enabled`	boolean	`true`	Ob Nutzungstelemetrie gesendet wird. Deaktivieren verhindert die Erfassung von Nutzungsdaten.
`telemetry.excludePayload`	boolean	—	IBM-Nutzer: Konversations-Payload von der Telemetrie ausschließen. Nur für genehmigte sensible Projekte aktivieren.

Warnung:

Setze tasks.retentionDays nur in Bob Shell 2.0.1 oder höher auf 0. Wenn du diesen Wert in früheren Versionen auf 0 setzt, können nicht angeheftete Aufgaben und ihr Verlauf gelöscht werden.

Authentifizierungstoken (OAuth) werden separat in ~/.bob/settings/auth-secrets.json gespeichert.

Protokolle werden in ~/.bob/logs/shell/ mit rotierenden Dateien (bob-<timestamp>.log) geschrieben. Bis zu 10 Protokolldateien werden aufbewahrt; ältere Dateien werden automatisch bereinigt. Die maximale Protokolldateigröße beträgt 5 MB vor der Rotation.

Verwende --log-level debug (oder BOB_LOG_LEVEL=debug) für ausführliche Ausgabe:

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

Du kannst die neueste Protokolldatei auch direkt aus einer Sitzung über den /logs-Slash-Befehl öffnen.

Kontextdateien

Kontextdateien (wie AGENTS.md) geben dem KI-Modell Anweisungen. Diese Dateien werden hierarchisch geladen:

Globaler Kontext: ~/.bob/AGENTS.md (gilt für alle Projekte)

Projektkontext: AGENTS.md im Projektstammverzeichnis und übergeordneten Verzeichnissen

Lokaler Kontext: AGENTS.md in Unterverzeichnissen (für komponentenspezifische Anweisungen)

Beispiel-Kontextdatei

# 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 `!==`)

Nutzungsstatistiken

Bob Shell erfasst anonyme Nutzungsstatistiken zur Produktverbesserung. Dies umfasst:

Tool-Nutzungsmuster (Namen, Erfolg/Fehler, Dauer)

API-Anfragenmetriken (Modell, Dauer, Erfolg)

Sitzungskonfigurationsinformationen

Es werden keine persönlichen Informationen, Prompt-Inhalte oder Dateiinhalte erfasst.

Um dich abzumelden, setze telemetry.enabled in deiner Einstellungsdatei auf false:

{
  "telemetry": {
    "enabled": false
  }
}

Konfiguration

Speicherorte der Einstellungsdatei

Einstellungsschema

Protokolldateien

Kontextdateien

Beispiel-Kontextdatei

Nutzungsstatistiken

Auf dieser Seite