Instalar a TUI

A TUI é o agente completo dentro do seu terminal, distribuída como um único binário chamado imaginne. A instalação não exige sudo.

Antes de começar

Você precisa de uma conta na sua organização. Veja Identidade & login. A TUI requer um terminal interativo (com TTY) — não funciona em pipes ou logs sem terminal.

Instalar

Rode o instalador oficial. Ele baixa o binário e o coloca em ~/.imaginne/bin (não usa sudo):

curl -fsSL https://ai.nnumbers.com.br/downloads/install.sh | bash

Inspecionar antes de executar

Executar um script direto da rede significa confiar nele sem ver o que faz. Em máquina corporativa, ou sob política de segurança, prefira as duas etapas:

# 1. Baixe o instalador
curl -fsSL https://ai.nnumbers.com.br/downloads/install.sh -o install-imaginne.sh

# 2. Leia o que ele vai fazer
less install-imaginne.sh

# 3. Execute
bash install-imaginne.sh

O instalador não usa sudo: ele escreve apenas em ~/.imaginne/. Se algum passo pedir elevação de privilégio, interrompa e procure a equipe que administra o Imaginne na sua organização.

Reabra o terminal (ou recarregue o PATH) para que o comando imaginne fique disponível. O instalador adiciona ~/.imaginne/bin ao seu PATH automaticamente; se preferir cuidar disso por conta própria, veja a variável IMAGINNE_SKIP_PATH_SETUP abaixo.

Confirme a instalação:

imaginne version

Primeira execução

Inicie o agente:

imaginne

Não há assistente de configuração. Na primeira execução, a TUI abre o login no navegador automaticamente; conclua o login e volte ao terminal. A partir daí, a tela de chat aparece — digite uma mensagem e pressione Enter. Veja Usar a TUI.

Canais: PROD e DEV

A TUI tem dois canais, que convivem lado a lado porque usam pastas de configuração diferentes:

Canal	Comando	Pasta de configuração	Aponta para
PROD (padrão)	imaginne	~/.imaginne/	ai.nnumbers.com.br
DEV	imaginne-dev	~/.imaginne-dev/	ambiente de validação da organização

Use o canal DEV apenas se a sua organização indicar. Veja os canais.

Subcomandos

Rodar imaginne sem argumentos abre o chat. Os subcomandos cobrem manutenção e sessão de login:

Comando	O que faz
imaginne (ou imaginne chat)	Abre o chat interativo.
imaginne version	Mostra a versão instalada.
imaginne update	Atualiza o binário para a última versão do canal.
imaginne config init	Cria/inicializa o ~/.imaginne/config.yaml.
imaginne login	Faz o login pelo navegador.
imaginne logout	Encerra a sessão local.
imaginne whoami	Mostra a sua identidade (sem expor o token).
imaginne serve	Sobe o modo de integração (usado pela extensão do VS Code).
imaginne password-login	Login legado por senha. Prefira login.

Flags da raiz

Flag	Efeito
--config <caminho>	Usa um arquivo de configuração específico.
--dangerous-bypass	Inicia em modo de execução permissivo (veja Autonomia).
-v, --version	Imprime a versão.

--dangerous-bypass exige intenção

O modo permissivo só fica disponível quando você inicia o binário com essa flag — não dá para ativá-lo apenas pela configuração. Mesmo assim, os limites de workspace e a auditoria continuam valendo. Veja Autonomia & permissões.

Voz

A voz na TUI depende do build com a tag voice. Hoje, apenas o release darwin-arm64 (macOS com chip Apple) traz essa capacidade; em outras plataformas a voz pode não estar disponível. Quando presente, dispare com Ctrl+G ou F2: a transcrição é anexada à sua mensagem (não envia sozinha) e Esc cancela. Detalhes em Voz.

Variáveis do instalador

Você pode ajustar a instalação exportando variáveis antes de rodar o install.sh:

Variável	Para quê
IMAGINNE_BASE_URL	Sobrescreve a URL base de download/ambiente.
IMAGINNE_CHANNEL	Escolhe o canal a instalar (ex.: dev).
IMAGINNE_INSTALL_ROOT	Muda a pasta de instalação (padrão ~/.imaginne).
IMAGINNE_SKIP_PATH_SETUP=1	Não mexe no PATH — você ajusta manualmente.

Exemplo, instalando o canal DEV em um diretório customizado:

IMAGINNE_CHANNEL=dev IMAGINNE_INSTALL_ROOT="$HOME/.imaginne-dev" \
  bash -c "$(curl -fsSL https://ai.nnumbers.com.br/downloads/install.sh)"

Variáveis de runtime

As variáveis acima são do instalador. Há também variáveis de ambiente que afetam a TUI em execução (IMAGINNE_DEBUG, IMAGINNE_DANGEROUS_BYPASS, vars de voz, entre outras) — consulte Variáveis de ambiente.

Veja também

⌨️Usar a TUI

Comandos de barra, @-menções, modos e atalhos.

Abrir →📋Comandos da TUI

Referência completa de comandos e teclas.

Abrir →🚀Início rápido

Do download à primeira tarefa.

Abrir →