Emplacements des fichiers de paramètres

Bob Shell stocke les paramètres dans deux emplacements :

Portée	Fichier
Utilisateur (tous les espaces de travail)	`~/.bob/settings/settings.json`
Projet (espace de travail actuel)	`<workspace>/.bob/`

Les flags CLI remplacent toujours les valeurs du fichier pour la session en cours. Tu peux aussi modifier les paramètres de façon interactive avec la slash command /settings dans bob chat.

Schéma des paramètres

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

Paramètre	Type	Défaut	Description
`session.maxTurns`	number	`100`	Nombre maximal de tours agentiques par session (`0` = illimité)
`session.defaultMode`	string	`"agent"`	Mode par défaut au démarrage d'une session
`session.mcp`	boolean	`true`	Activer les serveurs Model Context Protocol (MCP) par défaut
`session.subagents`	boolean	`true`	Activer la création de sous-agents par défaut
`logging.logLevel`	string	`"warn"`	Verbosité des logs (`error`, `warn`, `info`, `debug`, `trace`)
`tasks.retentionDays`	number	`30`	Nombre de jours après lesquels les tâches non épinglées sont automatiquement supprimées. Les tâches épinglées ne sont jamais supprimées automatiquement. Définis la valeur sur `0` pour désactiver le nettoyage automatique et conserver tout l'historique des tâches.
`telemetry.enabled`	boolean	`true`	Si la télémétrie d'utilisation est envoyée. La désactiver empêche la collecte de données d'utilisation.
`telemetry.excludePayload`	boolean	—	Utilisateurs IBM : exclure le contenu de la conversation de la télémétrie. À activer uniquement pour les projets sensibles approuvés.

Avertissement :

Ne définis tasks.retentionDays sur 0 que dans Bob Shell 2.0.1 ou version ultérieure. Définir cette valeur sur 0 dans les versions antérieures peut supprimer les tâches non épinglées et leur historique.

Les tokens d'authentification (OAuth) sont stockés séparément dans ~/.bob/settings/auth-secrets.json.

Fichiers de logs

Les logs sont écrits dans ~/.bob/logs/shell/ avec des fichiers rotatifs (bob-<timestamp>.log). Jusqu'à 10 fichiers de log sont conservés ; les fichiers plus anciens sont supprimés automatiquement. La taille maximale d'un fichier de log est de 5 Mo avant rotation.

Utilise --log-level debug (ou BOB_LOG_LEVEL=debug) pour capturer la sortie verbose :

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

Tu peux aussi ouvrir le dernier fichier de log directement depuis une session en utilisant la slash command /logs.

Fichiers de contexte

Les fichiers de contexte (comme AGENTS.md) fournissent des instructions au modèle d'IA. Ces fichiers sont chargés de façon hiérarchique :

Contexte global : ~/.bob/AGENTS.md (s'applique à tous les projets)

Contexte du projet : AGENTS.md dans la racine du projet et les répertoires parents

Contexte local : AGENTS.md dans les sous-répertoires (pour les instructions spécifiques aux composants)

Exemple de fichier de contexte

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

Statistiques d'utilisation

Bob Shell collecte des statistiques d'utilisation anonymes pour améliorer le produit. Cela inclut :

Les modèles d'utilisation des outils (noms, succès/échec, durée)

Les métriques des requêtes API (modèle, durée, succès)

Les informations de configuration des sessions

Aucune information personnelle, contenu de prompt ou contenu de fichier n'est collecté.

Pour désactiver, définis telemetry.enabled à false dans ton fichier de paramètres :

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

Configuration