Pular para o conteúdo principal
O TYBA lê um arquivo de configuração da sua home:
Ele não é criado na instalação. Se não existir, o TYBA usa os padrões e não reclama. Crie na mão quando precisar. O caminho é sempre $HOME/.tyba/config.toml, em qualquer sistema. Não há variação por plataforma — nem %APPDATA% no Windows.
No Windows, o TYBA exige que a variável HOME esteja definida e seja um caminho absoluto. Ela não cai para %USERPROFILE%. Sem HOME, sessões de agente falham antes de subir.

​
O arquivo inteiro

Hoje existe um campo:
~/.tyba/config.toml
Seções e chaves desconhecidas são ignoradas em silêncio — não há erro de campo extra.

​
Que caminho vale

Cada entrada precisa ser absoluta ou começar com ~:
Caminho relativo é recusado:

​
Quando a mudança pega

O arquivo é lido uma vez por sessão de agente, no momento em que ela sobe. Não há watcher e não há hot reload. Na prática: você edita, salva, e a próxima sessão de agente que você criar já usa o valor novo. Não precisa reiniciar o TYBA. Sessões que já estão rodando seguem com o valor antigo até morrerem.

​
Quando o arquivo está errado

TOML malformado ou caminho relativo derruba a criação da sessão de agente. O TYBA não cai para o padrão — ele falha, com a mensagem apontando o erro.
Isso é deliberado: um arquivo de sandbox que não parseia é ambíguo demais para adivinhar. Arquivo ausente é diferente de arquivo quebrado — ausente é o caso normal e não dá erro.

​
O que ele não consegue afrouxar

read_allow não abre seus segredos. As negações são aplicadas depois de qualquer permissão e vencem sempre:
Mesmo read_allow = ["~"] — sua home inteira — deixa esses caminhos ilegíveis para o agente. Não há configuração que reverta isso.

​
Ele não faz nada no Windows

No Windows este campo é aceito, validado e descartado. Ele não tem efeito nenhum.
Isso não é um furo, é uma consequência de como cada sistema contém a leitura:
  • macOS e Linux — a leitura é fechada por padrão. read_allow é o que abre exceções. Sem ele, o agente não lê o caminho.
  • Windows — a leitura é aberta por padrão, e só uma lista de segredos conhecidos é fechada. Não existe o que abrir: o que read_allow concederia já está concedido.
O campo é inerte ali porque não há tranca para afrouxar. Se você usa Windows, leia Plataformas — a diferença é maior que este campo e vale entender.

​
Veja também