Configuração

Provedores e clientes usam a mesma API de produção, https://api.hashiro.ai/api/. Configure um perfil para sua organização. O token determina identidade, organização, licença e permissões; o nome do perfil não concede acesso de provedor.

Criar o arquivo

Gere um token em Minha conta no console Hashiro. Crie o arquivo:

Sistema	Arquivo
macOS / Linux	~/.config/galileo/config.toml
Windows	%USERPROFILE%\.config\galileo\config.toml

No macOS ou Linux:

mkdir -p ~/.config/galileo
$EDITOR ~/.config/galileo/config.toml
chmod 600 ~/.config/galileo/config.toml

No PowerShell do Windows:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.config\galileo"
notepad "$env:USERPROFILE\.config\galileo\config.toml"

Cole a configuração e substitua o valor de exemplo pelo token:

current_project = ""
no_update = false
no_skills_update = true

[[profiles]]
name = "hashiro"
default = true
api_address = "https://api.hashiro.ai/api/"
api_key = "REPLACE_WITH_YOUR_API_TOKEN"

Referência dos campos

Campo	Significado
current_project	Identificador do projeto padrão. Vazio até selecionar um projeto.
no_update	true desativa atualização automática do binário. O padrão é false.
no_skills_update	true desativa atualização automática dos arquivos de comandos Claude Code instalados.
[[profiles]]	Entrada de array TOML, obrigatória mesmo com um perfil.
name	Nome local da conexão.
default	true seleciona o perfil padrão.
api_address	Use sempre https://api.hashiro.ai/api/. O Galileo normaliza o sufixo da API.
api_key	Token gerado pelo usuário.
proxy	URL opcional de proxy HTTP. Omita quando não precisar.
default_project	Identificador opcional dentro do perfil, carregado como projeto atual.

Não use [profiles.default], url, token ou current_program, pois não correspondem ao formato atual.

Acesso de provedores e clientes

Tokens de provedor acessam os dados próprios e de clientes vinculados nas operações permitidas. Tokens de cliente ficam restritos à própria organização. O endereço da API é igual para ambos. Associação e propriedade do projeto também determinam as operações disponíveis.

Verificar a conexão

galileo config profile list
galileo config profile default
galileo projects list

O perfil padrão aparece com *. A listagem é somente leitura e mostra projetos autorizados.

Selecionar projeto padrão

galileo projects default my-project
galileo projects default
galileo assets list
galileo assets list --project another-project
galileo projects default --unset

--project escolhe o projeto de uma chamada. Mantenha current_project no nível principal para usar o comando de seleção; default_project no perfil pode definir novamente o projeto a cada carregamento.

Proxy

galileo config proxy set http://127.0.0.1:8080
galileo config proxy unset

Os comandos alteram o perfil padrão. O proxy não muda a instância nem as permissões.

Gerenciar a configuração

galileo config set ./config.toml copia um arquivo TOML para o caminho padrão. Não define pares de chave e valor. Crie o arquivo padrão antes da primeira chamada, pois a configuração é carregada antes de executar comandos.

Com um perfil, não é necessário alternar conexões. Se adicionar outra identidade na mesma instância, galileo config profile default NAME define o padrão e --profile NAME seleciona um perfil para uma chamada.

Atualizações e diagnóstico

Use galileo --no-update projects list para pular a atualização automática em uma chamada. galileo update verifica explicitamente mesmo com atualizações automáticas desativadas.

Problema	Verificação
Arquivo ausente	Crie no caminho indicado para o sistema.
Erro de TOML	Use [[profiles]], strings entre aspas e opções globais antes do perfil.
Falha de autenticação	Troque o exemplo por um token válido; gerar outro invalida o anterior.
Acesso negado	Confira função, licença, associação ao projeto e vínculo da organização.
Projeto incorreto	Use --project ou revise o padrão salvo.

O arquivo contém uma credencial. Mantenha-o privado e fora do controle de versão.