Puoi configurare Bob Shell per adattarlo alle tue preferenze di flusso di lavoro.

Posizioni del file di impostazioni

Bob Shell archivia le impostazioni in due posizioni:

Ambito	File
Utente (tutti i workspace)	`~/.bob/settings/settings.json`
Progetto (workspace corrente)	`<workspace>/.bob/`

I flag CLI sostituiscono sempre i valori del file per la sessione corrente. Puoi anche modificare le impostazioni in modo interattivo con il comando slash /settings all'interno di bob chat.

Schema delle impostazioni

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

Impostazione	Tipo	Predefinito	Descrizione
`session.maxTurns`	number	`100`	Turni agentici massimi per sessione (`0` = illimitato)
`session.defaultMode`	string	`"agent"`	Modalità predefinita all'avvio di una sessione
`session.mcp`	boolean	`true`	Abilita i server Model Context Protocol (MCP) per impostazione predefinita
`session.subagents`	boolean	`true`	Abilita la creazione di subagent per impostazione predefinita
`logging.logLevel`	string	`"warn"`	Verbosità dei log (`error`, `warn`, `info`, `debug`, `trace`)
`tasks.retentionDays`	number	`30`	Numero di giorni dopo i quali i task non fissati vengono eliminati automaticamente. I task fissati non vengono mai eliminati automaticamente. Imposta il valore su `0` per disabilitare la pulizia automatica e conservare tutta la cronologia dei task.
`telemetry.enabled`	boolean	`true`	Se la telemetria di utilizzo viene inviata. La disabilitazione impedisce la raccolta dei dati di utilizzo.

Warning:

Imposta tasks.retentionDays su 0 solo in Bob Shell 2.0.1 o versioni successive. Impostare questo valore su 0 nelle versioni precedenti può eliminare i task non fissati e la loro cronologia.

I token di autenticazione (OAuth) vengono archiviati separatamente in ~/.bob/settings/auth-secrets.json.

I log vengono scritti in ~/.bob/logs/shell/ usando file rotativi (bob-<timestamp>.log). Vengono conservati al massimo 10 file di log; i file più vecchi vengono eliminati automaticamente. La dimensione massima di un file di log è 5 MB prima della rotazione.

Usa --log-level debug (o BOB_LOG_LEVEL=debug) per acquisire output dettagliato:

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

Puoi anche aprire l'ultimo file di log direttamente dall'interno di una sessione usando il comando slash /logs.

File di contesto

I file di contesto (come AGENTS.md) forniscono istruzioni al modello AI. Questi file vengono caricati in modo gerarchico:

Contesto globale: ~/.bob/AGENTS.md (si applica a tutti i progetti)

Contesto del progetto: AGENTS.md nella radice del progetto e nelle directory padre

Contesto locale: AGENTS.md nelle sottodirectory (per istruzioni specifiche dei componenti)

Esempio di file di contesto

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

Statistiche di utilizzo

Bob Shell raccoglie statistiche di utilizzo anonime per migliorare il prodotto. Questo include:

Pattern di utilizzo degli strumenti (nomi, successo/fallimento, durata)

Metriche delle richieste API (modello, durata, successo)

Informazioni sulla configurazione della sessione

Non vengono raccolte informazioni personali, contenuto dei prompt o contenuto dei file.

Per rinunciare, imposta telemetry.enabled su false nel tuo file di impostazioni:

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

Configurazione

Posizioni del file di impostazioni

Schema delle impostazioni

File di log

File di contesto

Esempio di file di contesto

Statistiche di utilizzo

In questa pagina