Referência da TUI

Tabela de consulta para o terminal (TUI). Para o passo a passo, veja Usar a TUI. Inicie a interface com imaginne (ou imaginne chat); envie com Enter.

Comandos de barra

Digite / no início da mensagem. Os apelidos estão entre parênteses.

Comando	Apelidos	Efeito
/help	/h, /?	Mostra a ajuda.
/quit	/q, /exit	Sai da TUI.
/clear	/cls	Limpa a tela / a conversa.
/context clear	—	Limpa o contexto (reinicia o raciocínio sem apagar a transcrição).
/model	/m	Abre o seletor de modelo (filtrado pela política). Padrão nnumbers.
/autonomy	/a	Ajusta a autonomia: low / medium / high.
/verbose	/v	Ajusta o detalhamento: silent / medium / debug.
/version	—	Mostra a versão.
/update	—	Atualiza o binário.
/diagnostics	—	Coleta diagnóstico.
/status	—	Mostra o status atual da sessão.
/project	/p	Operações de projeto.
/skill	/skills	Gerencia skills (veja subcomandos).
/sessions	—	Gerencia sessões (veja subcomandos).
/plan	—	Entra no modo Plan.
/exe	/execute	Entra no modo Execute.
/ask	—	Entra no modo Ask.
/lang	/language, /idioma	Troca o idioma.
/remote	—	Pareamento remoto (veja subcomandos).
/init	—	Inicializa o projeto.
/iterate	/iter	Itera sobre a tarefa atual.
/agent	—	Gerencia subagentes (veja subcomandos).
/login	—	Faz login pelo navegador.
/logout	—	Sai da conta.
/whoami	—	Mostra a sua identidade (sem expor a sua sessão).
/policy	—	Mostra a política efetiva.
/memory	—	Abre a memória do projeto.
/feedback	/fb	Envia feedback.
/todo	—	Lista de tarefas da sessão.

Subcomandos de /skill

Subcomando	Efeito
/skill list	Lista as skills disponíveis.
/skill info <nome>	Detalhes de uma skill.
/skill validate [path|key]	Valida o manifesto de uma skill.
/skill groups [--search q]	Lista os grupos de skill.
/skill publish <key|--skill-path p> --group <slug|id> [--mode]	Publica uma skill em um grupo.
/skill status	Estado de sincronização das skills.

Subcomandos de /sessions

Subcomando	Efeito
/sessions list	Lista as sessões.
/sessions new <título>	Cria uma sessão.
/sessions switch <id>	Troca de sessão.
/sessions archive <id>	Arquiva uma sessão.
/sessions rename <id> <título>	Renomeia uma sessão.

Subcomandos de /agent

Subcomando	Efeito
/agent list	Lista os subagentes.
/agent spawn <tipo> <tarefa>	Inicia um subagente.
/agent status	Estado dos subagentes.
/agent cancel <id>	Cancela um subagente.
/agent metrics	Métricas dos subagentes.
/agent cost	Custo dos subagentes.

Tipos de subagente: explorer, analyzer, reviewer, implementer, tester, refactorer, documenter.

Subcomandos de /remote

Subcomando	Efeito
/remote	Mostra um código de pareamento (válido 30s).
/remote status	Estado do pareamento.
/remote stop	Encerra o pareamento.

Requer login pelo navegador. Abra <host>/remote no navegador e cole o código. Veja Usar remotamente.

Menções de arquivo (@)

Forma	Efeito
@caminho	Lê e injeta o conteúdo do arquivo inline.
@"caminho com espaços"	Caminho com espaços.
@/abs/caminho	Caminho absoluto.
@~/caminho	A partir do home.

Pula diretórios, binários e arquivos maiores que ~100 KB. Tab completa (modo path e modo fuzzy); ↑/↓ navegam.

Atalhos de teclado

Tecla	Ação
Enter	Envia a mensagem.
Esc	Cancela; Esc Esc limpa.
Ctrl+C	Sai.
Ctrl+G / F2	Voz (depende do build com a tag voice).
Ctrl+A	Autonomia.
Ctrl+T	Painel de tarefas.
Ctrl+X	Verbose.
Ctrl+K	Limpa a tela.
Ctrl+O	Limpa o contexto.
Ctrl+Y / F1	Ajuda.
Shift+Tab	Cicla o modo (Execute / Plan / Ask).
Tab	Completa (menções e caminhos).
PgUp / PgDn	Rolam o viewport.

Subcomandos do binário

Comando	Efeito
imaginne	Abre o chat (padrão).
imaginne chat	Abre o chat.
imaginne version	Mostra a versão.
imaginne update	Atualiza o binário.
imaginne config init	Cria a configuração inicial.
imaginne login	Faz login pelo navegador.
imaginne logout	Sai da conta.
imaginne whoami	Mostra a identidade.
imaginne password-login	Login por senha (legado).
imaginne serve	Modo IDE (usado pela extensão do VS Code).

Flags raiz

Flag	Efeito
--config <path>	Usa um arquivo de configuração específico.
--dangerous-bypass	Habilita o modo de execução dangerous_bypass (veja Autonomia).
-v, --version	Mostra a versão.

Variáveis de ambiente do cliente

Veja a lista completa, com voz e instalador, em Variáveis de ambiente.

Variável	Efeito
IMAGINNE_DANGEROUS_BYPASS	Sinaliza o modo de execução perigoso na inicialização.
IMAGINNE_DEBUG	Ativa logs de depuração.
IMAGINNE_LEGACY	Liga comportamentos legados.
IMAGINNE_TUI_LOCAL_STORE=off	Desliga a persistência local de sessões.
IMAGINNE_GLOBAL_SKILLS_DIR	Sobrescreve o diretório global de skills.

Configuração (~/.imaginne/config.yaml)

Arquivo YAML com permissões 0600. Chaves principais:

Chave	Padrão	Para quê
llm.model	nnumbers	Modelo padrão.
llm.max_tokens	16384	Limite de geração.
llm.temperature	0.7	Temperatura.
memory.storage_path	—	Caminho da memória.

A conexão e a sessão são gerenciadas pelo login

Os dados de conexão e a sua sessão autenticada ficam neste arquivo, mas são preenchidos e mantidos automaticamente pelo login — você não precisa (nem deve) editá-los à mão.

Próximos passos

• Usar no terminal
• Instalar a TUI