Puedes configurar Bob Shell para que se adapte a tus preferencias de flujo de trabajo.

Ubicaciones del archivo de configuración

Bob Shell almacena la configuración en dos ubicaciones:

Alcance	Archivo
Usuario (todos los workspaces)	`~/.bob/settings/settings.json`
Proyecto (workspace actual)	`<workspace>/.bob/`

Los indicadores de CLI siempre sobreescriben los valores del archivo para la sesión actual. También puedes cambiar la configuración de forma interactiva a través del slash command /settings dentro de bob chat.

Esquema de configuración

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

Configuración	Tipo	Predeterminado	Descripción
`session.maxTurns`	number	`50`	Turnos agénticos máximos por sesión (`0` = ilimitado)
`session.defaultMode`	string	`"agent"`	Modo predeterminado al iniciar una sesión
`session.mcp`	boolean	`true`	Activar servidores Model Context Protocol (MCP) por defecto
`session.subagents`	boolean	`true`	Activar la creación de subagentes por defecto
`logging.logLevel`	string	`"warn"`	Nivel de detalle de logs (`error`, `warn`, `info`, `debug`, `trace`)
`tasks.retentionDays`	number	`30`	Número de días para conservar el historial de tareas. Establece el valor en `0` para desactivar la limpieza automática y conservar todo el historial de tareas.
`telemetry.enabled`	boolean	`true`	Si se envía telemetría de uso. Desactivarlo evita que se recopilen datos de uso.
`telemetry.excludePayload`	boolean	—	Usuarios IBM: excluir el payload de conversación de la telemetría. Solo actívalo para proyectos sensibles aprobados.

Advertencia:

Solo establece tasks.retentionDays en 0 en Bob Shell 2.0.1 o posterior. Establecer este valor en 0 en versiones anteriores puede eliminar tareas no fijadas y su historial.

Los tokens de autenticación (OAuth) se almacenan por separado en ~/.bob/settings/auth-secrets.json.

Archivos de log

Los logs se escriben en ~/.bob/logs/shell/ usando archivos rotativos (bob-<timestamp>.log). Se conservan hasta 10 archivos de log; los más antiguos se eliminan automáticamente. El tamaño máximo de un archivo de log es de 5 MB antes de la rotación.

Usa --log-level debug (o BOB_LOG_LEVEL=debug) para capturar salida detallada:

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

También puedes abrir el archivo de log más reciente directamente desde una sesión usando el slash command /logs.

Archivos de contexto

Los archivos de contexto (como AGENTS.md) proporcionan instrucciones al modelo de IA. Estos archivos se cargan de forma jerárquica:

Contexto global: ~/.bob/AGENTS.md (se aplica a todos los proyectos)

Contexto del proyecto: AGENTS.md en la raíz del proyecto y los directorios principales

Contexto local: AGENTS.md en subdirectorios (para instrucciones específicas de componentes)

Ejemplo de archivo de contexto

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

Estadísticas de uso

Bob Shell recopila estadísticas de uso anónimas para mejorar el producto. Esto incluye:

Patrones de uso de herramientas (nombres, éxito/fallo, duración)

Métricas de solicitudes de API (modelo, duración, éxito)

Información de configuración de la sesión

No se recopila información personal, contenido de prompts ni contenido de archivos.

Para desactivar, establece telemetry.enabled en false en tu archivo de configuración:

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

Configurar