Configurações e arquivos

Onde cada coisa fica (Linux)

#

$XDG_CONFIG_HOME e $XDG_DATA_HOME substituem ~/.config e ~/.local/share quando estão definidas. Settings → About mostra a versão do app e os caminhos reais.

settings.json

#

{
  "version": 22,
  "connectors": { "github": true },
  "sounds": true,
  "volume": 50,
  "fold_after": 15,
  "api_provider": "openrouter",
  "api_models": { "openrouter": "anthropic/claude-opus-5.5" }
}

Configurações de agentes que o Vults edita

#

Só quando você clica em Write the file, depois de um backup datado e de um diff que você revisou:

O Vults não suporta mais o Gemini CLI. Enquanto os hooks que um Vults anterior instalou em ~/.gemini/settings.json continuarem lá, eles não mandam nada, e Settings → Agents mostra um card do Gemini CLI cujo único botão é Remove hooks… (o mesmo diff, backup datado e clique).

A variável de pasta de cada agente move o arquivo dele, lida do jeito que o agente a lê: CLAUDE_CONFIG_DIR (Claude Code, no lugar de ~/.claude), CODEX_HOME (Codex, no lugar de ~/.codex, o config.toml também), QWEN_HOME (Qwen Code, no lugar de ~/.qwen), COPILOT_HOME (Copilot CLI, no lugar de ~/.copilot), FACTORY_HOME_OVERRIDE (Factory Droid, no lugar da home: a .factory dele fica dentro), KIMI_CODE_HOME (Kimi Code, no lugar de ~/.kimi-code) e GEMINI_CLI_HOME (o Gemini CLI guarda a sua .gemini dentro dela; lida só para achar os hooks antigos a remover). Aberto pelo desktop, o app não vê o que os arquivos de inicialização do seu shell exportam, então ele pergunta ao seu shell de login uma vez, quando abre, e guarda só essas sete; um shell que leva mais de dois segundos é deixado de lado, e valem as pastas de sempre. O Claude Code e o Codex que o próprio app abre (o chat, a leitura de uso do Codex) também as recebem, então usam as mesmas pastas que no seu terminal. Cada card em Settings → Agents mostra o arquivo que ele edita. O OPENCODE_CONFIG_DIR do OpenCode ainda não é seguido.

Uma escrita nunca deixa meio arquivo: o texto novo vai para um arquivo próprio ao lado, é gravado no disco e só então toma o lugar do antigo. Um arquivo com outros nomes (um hard link, como fazem alguns gerenciadores de dotfiles e ferramentas de backup) é escrito no próprio lugar, então todos os nomes veem a mudança. Um arquivo salvo com marca de ordem de bytes (BOM) ou com quebras de linha do Windows (CRLF) continua com elas.

Entradas de outras ferramentas são mantidas, e Remove hooks… tira só as nossas. Se você colocar o hook de outra ferramenta no mesmo grupo que o nosso, esse grupo fica: uma atualização muda só o nosso hook nele, e Remove tira só o nosso hook. No Codex, um hook ou grupo que vinha depois de um dos nossos que removemos sobe uma posição, então o Codex pode pedir que você confie nele de novo em /hooks. Uma atualização muda as nossas entradas onde elas estão: o arquivo mantém a ordem das chaves, então o diff mostra só o que mudou. Hooks que executam outra cópia do vults-hook (de outra pasta de dados) avisam isso em Settings → Agents, e Update hooks… os aponta para o deste app (se o seu próprio status line estiver salvo ao lado daquele outro hook, o card não oferece atualização e avisa: remova os hooks primeiro, veja abaixo).

Uma configuração tem um único statusLine, e o Claude Code informa o uso do plano só para ele. Se você tem um seu, a instalação salva o objeto inteiro dele em statusline-previous.json ao lado do hook e muda só o command dele para o nosso (o seu padding e os outros campos ficam); o diff mostra os dois arquivos. O nosso então entrega o uso ao app, executa o seu comando com a mesma entrada (via sh -c, por até 10 segundos) e imprime exatamente o que ele imprime (até 64 KiB), cores incluídas. Se o seu comando sumiu, não consegue iniciar ou demora mais, o status line fica em branco daquela vez, o que ele tiver iniciado em segundo plano também é parado, e o Claude Code segue em frente. Remove hooks… devolve o seu objeto como estava; um statusLine que você mudou desde então não é mais nosso e fica como está. Hooks instalados por outra pasta de dados mantêm a sua linha ao lado do hook deles: remova-os antes de instalar a partir desta.

Ambiente

#