Podes configurar Bob Shell de acordo com as preferências do teu fluxo de trabalho.

Localizações do ficheiro de definições

Bob Shell guarda as definições em dois locais:

Âmbito	Ficheiro
Utilizador (todos os workspaces)	`~/.bob/settings/settings.json`
Projeto (workspace atual)	`<workspace>/.bob/`

As flags CLI substituem sempre os valores do ficheiro para a sessão atual. Também podes alterar as definições de forma interativa através do slash command /settings dentro de bob chat.

Schema de definições

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

Definição	Tipo	Padrão	Descrição
`session.maxTurns`	number	`50`	Número máximo de turnos agênticos por sessão (`0` = ilimitado)
`session.defaultMode`	string	`"agent"`	Modo padrão ao iniciar uma sessão
`session.mcp`	boolean	`true`	Ativar servidores Model Context Protocol (MCP) por padrão
`session.subagents`	boolean	`true`	Ativar criação de subagentes por padrão
`logging.logLevel`	string	`"warn"`	Verbosidade do log (`error`, `warn`, `info`, `debug`, `trace`)
`tasks.retentionDays`	number	`30`	Número de dias para reter o histórico de tarefas. Define o valor como `0` para desativar a limpeza automática e manter todo o histórico de tarefas.
`telemetry.enabled`	boolean	`true`	Se a telemetria de utilização é enviada. Desativar impede a recolha de dados de utilização.

Warning:

Define tasks.retentionDays como 0 apenas no Bob Shell 2.0.1 ou posterior. Definir este valor como 0 em versões anteriores pode eliminar tarefas não fixadas e o respetivo histórico.

Os tokens de autenticação (OAuth) são armazenados separadamente em ~/.bob/settings/auth-secrets.json.

Os logs são escritos em ~/.bob/logs/shell/ usando ficheiros rotativos (bob-<timestamp>.log). São retidos até 10 ficheiros de log; os ficheiros mais antigos são eliminados automaticamente. O tamanho máximo do ficheiro de log é 5 MB antes da rotação.

Usa --log-level debug (ou BOB_LOG_LEVEL=debug) para capturar output detalhado:

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

Também podes abrir o último ficheiro de log diretamente a partir de uma sessão usando o slash command /logs.

Ficheiros de contexto

Os ficheiros de contexto (como AGENTS.md) fornecem instruções ao modelo de IA. Estes ficheiros são carregados hierarquicamente:

Contexto global: ~/.bob/AGENTS.md (aplica-se a todos os projetos)

Contexto do projeto: AGENTS.md na raiz do projeto e diretórios pai

Contexto local: AGENTS.md em subdiretórios (para instruções específicas de componentes)

Exemplo de ficheiro 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 `!==`)

Estatísticas de utilização

Bob Shell recolhe estatísticas de utilização anónimas para melhorar o produto. Isto inclui:

Padrões de uso de tools (nomes, sucesso/falha, duração)

Métricas de pedidos à API (modelo, duração, sucesso)

Informações de configuração da sessão

Nenhuma informação pessoal, conteúdo de prompts ou conteúdo de ficheiros é recolhido.

Para desativar, define telemetry.enabled como false no teu ficheiro de definições:

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

Configurar

Localizações do ficheiro de definições

Schema de definições

Ficheiros de log

Ficheiros de contexto

Exemplo de ficheiro de contexto

Estatísticas de utilização

Nesta página