Configuração
hinow.json e tui.json: onde ficam, quem vence, as chaves que importam, valores dinâmicos.
Atualizado em 16 de set. de 2026
Tudo o que o HiNow Code faz por padrão pode ser ajustado, e isso acontece em dois arquivos JSON. O hinow.json cuida do agente: modelo, permissões, agentes, comandos, servidores MCP, plugins. O tui.json cuida da interface: tema, atalhos, rolagem. Os dois aceitam comentários e vírgula sobrando, e a extensão .jsonc também vale.
| Arquivo | Vale para |
|---|---|
~/.config/hinow/hinow.json | Você, em todos os projetos (**global**) |
hinow.json ou .hinow/hinow.json na pasta do projeto | Aquele projeto. Ele procura da pasta atual até a raiz do repositório |
~/.config/hinow/tui.json | A interface, em todos os projetos |
.hinow/tui.json | A interface, naquele projeto |
Os arquivos são somados, chave a chave, e o do projeto ganha do global. Uma chave desconhecida faz o programa recusar a configuração inteira ao abrir, por isso vale manter o $schema na primeira linha: o editor aponta o erro enquanto você digita, antes de doer.
{
"$schema": "https://hinow.ai/config.json",
"model": "hinow/hinow/hicode",
"instructions": ["docs/estilo.md"],
"permission": {
"bash": { "git *": "allow", "pytest*": "allow", "rm -rf *": "deny", "*": "ask" }
}
}A configuração é lida ao abrir
Mudou um arquivo de configuração, um agente, uma skill ou um plugin? Feche e abra o HiNow Code (ou reinicie o serve). A sessão em andamento continua com o que já tinha carregado.
| Chave | O que controla |
|---|---|
model | Modelo padrão, como provedor/modelo. No HINOW: hinow/hinow/hicode |
small_model | Modelo para tarefas pequenas (título da sessão, resumo) |
default_agent | Agente que abre selecionado (build, plan ou um seu, em modo primary) |
instructions | Arquivos de regras além do AGENTS.md: ["docs/estilo.md", ".regras/*.md"] |
permission | O que ele faz sozinho, pergunta ou nunca faz. Veja [Permissões e segurança](/pt/cli/usage/permissions) |
agent | Agentes definidos aqui, em vez de em arquivos. Veja [Agentes](/pt/cli/customize/agents) |
command | Comandos com barra definidos aqui. Veja [Comandos próprios](/pt/cli/customize/commands) |
skills | paths (pastas extras com skills) e urls. Veja [Skills](/pt/cli/customize/skills) |
mcp | Servidores MCP. Veja [Servidores MCP](/pt/cli/customize/mcp) |
plugin | Plugins do npm ou arquivos locais. Veja [Plugins e ferramentas](/pt/cli/customize/plugins) |
tools | Ligar ou desligar ferramentas: {"websearch": false, "mcp_*": false} |
formatter | true/false, ou comandos por extensão de arquivo, para formatar o que ele edita |
lsp | true/false ou configuração por linguagem: erros de compilação e navegação de símbolos para o agente |
share | Link público de sessões: desligado por padrão; "manual" liga o /share, "auto" publica toda sessão nova |
autoupdate | false desliga o aviso de versão nova; "notify" só avisa |
compaction | {"auto": true, "tail_turns": 15}: quando e como resumir a conversa sozinho |
tool_output | {"max_lines": 2000, "max_bytes": …}: a partir de quanto a saída de uma ferramenta vai para arquivo |
references | Pastas ou repositórios de fora do projeto que o agente pode consultar (@docs, @sdk) |
username | Seu nome na conversa |
shell | Shell dos comandos (/bin/zsh…) |
Qualquer texto na configuração aceita {env:NOME}, que vira o valor de uma variável de ambiente, e {file:caminho}, que vira o conteúdo de um arquivo. É assim que um token fica fora do repositório:
"mcp": {
"github": {
"type": "remote",
"url": "https://api.githubcopilot.com/mcp/",
"headers": { "Authorization": "Bearer {env:GITHUB_TOKEN}" }
}
}hinow-cli debug config imprime a configuração final, já somada, com a origem de cada valor. hinow-cli debug paths mostra onde estão dados, configuração, cache e estado. Na interface, /configs mostra as opções da tela e /status o que está ligado (MCPs, formatadores, LSP, plugins).
Se o programa não abre por causa de um arquivo inválido: HINOW_DISABLE_PROJECT_CONFIG=1 hinow-cli ignora o do projeto; HINOW_CONFIG=/outro/arquivo.json carrega um arquivo explícito; HINOW_PURE=1 abre sem plugins externos. Corrija o arquivo e volte ao normal.
A interface tem o próprio arquivo, com $schema em https://hinow.ai/tui.json: theme, keybinds, scroll_speed, scroll_acceleration, diff_style (auto ou stacked), mouse, cursor, attention (aviso e som quando a resposta termina), leader_timeout. Veja Temas e atalhos.