Configuração

O IaC Code lê a configuração a partir de argumentos CLI, variáveis de ambiente e arquivos no diretório de configuração em tempo de execução.

Precedência de configuração:

Argumentos CLI > variáveis de ambiente > arquivos de configuração

O diretório de tempo de execução padrão é:

~/.iac-code/

Você pode realocá-lo definindo a variável de ambiente IAC_CODE_CONFIG_DIR (suporta expansão de ~ e $VAR). Quando definida, todos os artefatos persistidos — credenciais, configurações, histórico, projects/, image-cache/, tool-results/, logs/, memory/, a2a/, telemetry/, skills/ — seguem o novo local.

Arquivos comuns:

Arquivo	Descrição
.credentials.yml	Credenciais LLM
.cloud-credentials.yml	Credenciais do provedor de nuvem
settings.yml	Provedor selecionado, modelo e configurações relacionadas
AGENTS.md	Memória do usuário carregada como instruções persistentes
history files	Histórico de entrada para fluxos de trabalho interativos

Evite fazer commit ou compartilhar arquivos deste diretório porque eles podem conter segredos ou preferências locais.

Arquivos de memória

O IaC Code tem dois locais públicos de memória:

Local	Finalidade
<project-root>/AGENTS.md	Memória do projeto. Pode ser commitada quando as instruções forem úteis para todas as pessoas que trabalham no projeto.
<config-dir>/AGENTS.md	Memória do usuário. Segue IAC_CODE_CONFIG_DIR e é privada para o usuário local.

Defina IAC_CODE_INSTRUCTION_MEMORY_FILE para usar outro nome de arquivo de memória de instruções, por exemplo IAC-CODE.md.

Os arquivos de tópicos de auto-memory do projeto são armazenados em:

<config-dir>/projects/<project-key>/memory/

MEMORY.md nessa pasta é o índice de tópicos usado pelas side calls de auto-memory. Ele não é carregado como contexto permanente. Quando auto-memory está ativada, o IaC Code pode selecionar arquivos de tópicos relevantes e adicioná-los como contexto oculto da conversa.

Configurações do projeto

Além do ~/.iac-code/settings.yml no nível do usuário, o IaC Code carrega configurações no nível do projeto a partir do diretório de trabalho atual:

Arquivo	Escopo
.iac-code/settings.yml	Configurações compartilhadas do projeto (seguro para commit).
.iac-code/settings.local.yml	Substituições locais (deve estar no .gitignore).

Ordem de mesclagem: configurações do usuário → configurações do projeto → configurações locais do projeto → argumentos CLI (fontes posteriores substituem as anteriores).

Configuração de permissões de ferramentas

A seção permissions em settings.yml configura quais ações de ferramentas são permitidas, negadas ou requerem confirmação:

permissions:
  mode: default
  allow:
    - "bash(git *)"
    - "bash(ls:*)"
  deny:
    - "bash(rm -rf *)"
  ask:
    - "bash(curl:*)"
  additional_directories:
    - "/tmp/workspace"

Campo	Descrição
mode	Modo de permissão: default, accept_edits, bypass_permissions, dont_ask.
allow	Lista de padrões de permissão de ferramentas para aprovação automática.
deny	Lista de padrões de permissão de ferramentas para negação automática.
ask	Lista de padrões de permissão de ferramentas que sempre requerem confirmação.
additional_directories	Diretórios adicionais além do cwd nos quais o agente pode escrever.

Sintaxe de padrões

Os padrões de permissão de ferramentas seguem o formato tool_name(rule):

Padrão	Significado
bash	Corresponder a todos os comandos bash (nome de ferramenta simples).
bash(git *)	Corresponder a comandos bash que começam com git.
bash(curl:*)	Corresponder a comandos bash que começam com curl.
write_file	Corresponder a todas as chamadas da ferramenta write_file.

As regras são avaliadas na ordem: deny → ask → allow → comportamento padrão. Os argumentos CLI (--allowed-tools, --disallowed-tools) têm a maior precedência.