Visão Geral de Configuração

Invowk™ usa um arquivo de configuração baseado em CUE para customizar seu comportamento. É aqui que você define suas preferências para container engines, caminhos de busca, padrões de runtime e mais.

Localização do Arquivo de Configuração

O arquivo de configuração fica no diretório de configuração específico do seu SO:

Plataforma	Localização
Linux	~/.config/invowk/config.cue
macOS	~/Library/Application Support/invowk/config.cue
Windows	%APPDATA%\invowk\config.cue

Atualmente, o Invowk lê a configuração do caminho específico do SO acima. Se não existir um arquivo ali, ele também procura por um config.cue no diretório atual. Se nenhum estiver presente, usa os padrões.

Criando um Arquivo de Configuração

A forma mais fácil de criar um arquivo de configuração é usar o comando config init:

invowk config init

Isso cria um arquivo de configuração padrão com valores sensatos. Se um arquivo de configuração já existir, ele não será sobrescrito (segurança em primeiro lugar!).

Visualizando Sua Configuração

Existem várias formas de inspecionar sua configuração atual:

Mostrar Configuração Legível

invowk config show

Isso exibe sua configuração em um formato amigável e legível.

Mostrar CUE Raw

invowk config dump

Isso exibe a configuração CUE raw, útil para debug ou copiar para outra máquina.

Encontrar o Arquivo de Configuração

invowk config path

Isso imprime o caminho para seu arquivo de configuração. Prático quando você quer editá-lo diretamente.

Definindo Valores de Configuração

Você pode modificar valores de configuração pela linha de comando:

# Set the container engine
invowk config set container_engine podman

# Set the default runtime
invowk config set default_runtime virtual

# Set the color scheme
invowk config set ui.color_scheme dark

Ou simplesmente abra o arquivo de configuração no seu editor favorito:

# Linux/macOS
$EDITOR $(invowk config path)

# Windows PowerShell
notepad (invowk config path)

Exemplo de Configuração

Aqui está como um arquivo de configuração típico se parece:

// ~/.config/invowk/config.cue

// Container engine: "podman" or "docker"
container_engine: "podman"

// Additional invkfiles and modules to include in discovery
includes: [
    {path: "~/.invowk/cmds/invkfile.cue"},
    {path: "~/projects/shared.invkmod", alias: "shared"},
]

// Default runtime for commands that don't specify one
default_runtime: "native"

// Virtual shell configuration
virtual_shell: {
    enable_uroot_utils: true
}

// UI preferences
ui: {
    color_scheme: "auto"  // "auto", "dark", or "light"
    verbose: false
    interactive: false    // Enable alternate screen buffer mode
}

// Container provisioning
container: {
    auto_provision: {
        enabled: true
    }
}

Próximos Passos

Vá para Opções de Configuração para uma referência completa de todas as configurações disponíveis.