Pular para o conteúdo principal
Versão: 0.1.0-alpha.1

Instalação

Software em Alfa

O Invowk™ está atualmente em estágio alfa. Embora busquemos estabilidade, espere mudanças incompatíveis entre versões enquanto estabilizamos o formato do invkfile, estrutura de módulos e conjunto de funcionalidades. Recomendamos fixar uma versão específica para uso em produção e acompanhar os lançamentos no GitHub para guias de migração.

Bem-vindo ao Invowk! Vamos configurar tudo para você executar comandos rapidamente.

Requisitos

Antes de instalar o Invowk, certifique-se de ter:

  • Go 1.26+ (apenas se compilar a partir do código-fonte)
  • Linux, macOS ou Windows - O Invowk funciona em todos os três!

Para recursos de runtime em container, você também precisará de:

  • Docker ou Podman instalado e em execução

Métodos de Instalação

A Partir do Código-Fonte (Recomendado por enquanto)

Se você tem o Go instalado, compilar a partir do código-fonte é simples:

git clone https://github.com/invowk/invowk
cd invowk
go build -o invowk .

Depois mova o binário para o seu PATH:

# Linux/macOS
sudo mv invowk /usr/local/bin/

# Or add to your local bin
mv invowk ~/.local/bin/

Usando Make (com mais opções)

O projeto inclui um Makefile com várias opções de compilação:

# Standard build (stripped binary, smaller size)
make build

# Development build (with debug symbols)
make build-dev

# Compressed build (requires UPX)
make build-upx

# Install to $GOPATH/bin
make install

Verificar Instalação

Uma vez instalado, verifique se tudo funciona:

invowk --version

Você deverá ver as informações de versão. Se receber um erro "command not found", certifique-se de que o binário está no seu PATH.

Autocompletar do Shell

O Invowk suporta autocompletar com tab para bash, zsh, fish e PowerShell. Isso torna a digitação de comandos muito mais rápida!

Bash

# Add to ~/.bashrc
eval "$(invowk completion bash)"

# Or install system-wide
invowk completion bash > /etc/bash_completion.d/invowk

Zsh

# Add to ~/.zshrc
eval "$(invowk completion zsh)"

# Or install to fpath
invowk completion zsh > "${fpath[1]}/_invowk"

Fish

invowk completion fish > ~/.config/fish/completions/invowk.fish

PowerShell

invowk completion powershell | Out-String | Invoke-Expression

# Or add to $PROFILE for persistence
invowk completion powershell >> $PROFILE

Próximos Passos

Agora que você tem o Invowk instalado, vá para o guia de Início Rápido para executar seu primeiro comando!