Instalação
O Invowk™ está atualmente em estágio alfa. Embora busquemos estabilidade, espere mudanças incompatíveis entre versões enquanto estabilizamos o formato do invowkfile, 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!