Variáveis de ambiente
Esta página lista apenas as variáveis de ambiente do lado do cliente: o binário imaginne (TUI), a voz e o instalador. Variáveis de servidor e de infraestrutura não são documentadas aqui.
Todas as variáveis abaixo afetam um aplicativo na sua máquina. Defina-as no seu shell antes de iniciar a TUI, ou passe-as ao comando de instalação.
TUI (binário imaginne)
| Variável | Efeito | Padrão |
|---|---|---|
IMAGINNE_DANGEROUS_BYPASS | Sinaliza o modo de execução dangerous_bypass na inicialização. Sem ela (ou sem a flag --dangerous-bypass), o pedido é rebaixado para auto. | desativado |
IMAGINNE_DEBUG | Ativa logs de depuração. | desativado |
IMAGINNE_LEGACY | Liga comportamentos legados. | desativado |
IMAGINNE_TUI_LOCAL_STORE | off desliga a persistência local de sessões (útil em máquinas compartilhadas). | ligado |
IMAGINNE_GLOBAL_SKILLS_DIR | Sobrescreve o diretório global de skills (padrão ~/.imaginne/skills/). | ~/.imaginne/skills/ |
Voz
As variáveis de voz (IMAGINNE_VOICE_*) ajustam a fala→texto na TUI e no Desktop. A voz depende do build compilado com a tag voice (hoje, na TUI, só o release darwin-arm64) e de credenciais habilitadas pela organização. Veja Voz.
| Variável | Efeito |
|---|---|
IMAGINNE_VOICE_* | Configuram parâmetros de captura/transcrição de voz (prefixo da família de variáveis de voz). |
Instalador (install.sh)
Passadas ao executar o script de instalação da TUI. Veja Instalar a TUI.
| Variável | Efeito | Padrão |
|---|---|---|
IMAGINNE_BASE_URL | Host base usado pela instalação. | host de produção |
IMAGINNE_CHANNEL | Canal a instalar (imaginne PROD ou imaginne-dev DEV). | imaginne |
IMAGINNE_INSTALL_ROOT | Diretório de instalação. | ~/.imaginne/bin |
IMAGINNE_SKIP_PATH_SETUP | 1 não modifica o PATH durante a instalação. | desativado |
Caminhos relacionados
Não são variáveis de ambiente, mas é útil ter em mãos:
| Caminho | Conteúdo |
|---|---|
~/.imaginne/config.yaml | Configuração e sessão (permissões 0600). Canal DEV: ~/.imaginne-dev/. |
~/.imaginne/skills/ | Skills globais. |
~/.imaginne/prefs.json | Preferências da TUI (autonomia, verbose). |
outputs/ | Saídas de skills no projeto. |
Próximos passos
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.