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
- 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
- Script Shell
- PowerShell (Windows)
- WinGet (Windows)
- Homebrew
- Go Install
- Código-Fonte
A forma mais rápida de instalar no Linux ou macOS:
curl -fsSL https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.sh | sh
Isso baixa a versão mais recente do GitHub, verifica o checksum SHA256 e instala em ~/.local/bin.
Personalizar a instalação:
# Install to a custom directory
INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.sh | sh
# Install a specific version
INVOWK_VERSION=v1.0.0 curl -fsSL https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.sh | sh
| Variável | Padrão | Descrição |
|---|---|---|
INSTALL_DIR | ~/.local/bin | Onde instalar o binário |
INVOWK_VERSION | última estável | Instalar uma versão específica (ex: v1.0.0) |
GITHUB_TOKEN | não definido | Opcional; evita limitação de taxa da API |
A forma mais rápida de instalar no Windows:
irm https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.ps1 | iex
Isso baixa a versão mais recente do GitHub, verifica o checksum SHA256 e instala em %LOCALAPPDATA%\Programs\invowk. O PATH do usuário é atualizado automaticamente.
Personalizar a instalação:
# Install to a custom directory
$env:INSTALL_DIR='C: oolsinvowk'; irm https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.ps1 | iex
# Install a specific version
$env:INVOWK_VERSION='v1.0.0'; irm https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.ps1 | iex
# Skip automatic PATH modification
$env:INVOWK_NO_MODIFY_PATH='1'; irm https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.ps1 | iex
| Variável | Padrão | Descrição |
|---|---|---|
INSTALL_DIR | %LOCALAPPDATA%\Programs\invowk | Onde instalar o binário |
INVOWK_VERSION | última estável | Instalar uma versão específica (ex: v1.0.0) |
INVOWK_NO_MODIFY_PATH | não definido | Defina como 1 para não modificar o PATH automaticamente |
GITHUB_TOKEN | não definido | Opcional; evita limitação de taxa da API |
Instale usando WinGet no Windows 10/11:
winget install Invowk.Invowk
Para atualizar depois:
winget upgrade Invowk.Invowk
Se você usa Homebrew no macOS ou Linux:
brew install invowk/tap/invowk
Para atualizar depois:
brew upgrade invowk
Se você tem Go 1.26+ instalado:
go install github.com/invowk/invowk@latest
O binário é instalado em $GOBIN (ou $GOPATH/bin).
Clone e compile a partir do código-fonte:
git clone https://github.com/invowk/invowk
cd invowk
make build
Depois instale em $GOPATH/bin:
make install
Ou mova o binário manualmente:
# Linux/macOS
sudo mv invowk /usr/local/bin/
# Or add to your local bin
mv invowk ~/.local/bin/
Nota: Em sistemas x86-64, a compilação padrão utiliza a microarquitetura x86-64-v3 (CPUs Haswell+ de 2013+) para desempenho otimizado. Para máxima compatibilidade com CPUs mais antigos, use
make build GOAMD64=v1.
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.
Suporte por Plataforma
| Método | Linux | macOS | Windows |
|---|---|---|---|
| Script shell | amd64, arm64 | amd64 (Intel), arm64 (Apple Silicon) | — |
| Script PowerShell | — | — | amd64 |
| WinGet | — | — | amd64 |
| Homebrew | amd64, arm64 | amd64, arm64 | — |
| Go install | todos | todos | todos |
| Código-fonte | todos | todos | todos |
Atualização
Atualize usando o mesmo método que você usou para instalar:
- Script shell: Execute novamente o comando de instalação — ele baixa a versão mais recente e substitui o binário existente:
curl -fsSL https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.sh | sh
Para atualizar para uma versão específica, defina INVOWK_VERSION:
# Install to a custom directory
INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.sh | sh
# Install a specific version
INVOWK_VERSION=v1.0.0 curl -fsSL https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.sh | sh
- Script PowerShell: Execute novamente o comando de instalação — ele baixa a versão mais recente e substitui o binário existente:
irm https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.ps1 | iex
Para atualizar para uma versão específica, defina INVOWK_VERSION:
# Install to a custom directory
$env:INSTALL_DIR='C: oolsinvowk'; irm https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.ps1 | iex
# Install a specific version
$env:INVOWK_VERSION='v1.0.0'; irm https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.ps1 | iex
# Skip automatic PATH modification
$env:INVOWK_NO_MODIFY_PATH='1'; irm https://raw.githubusercontent.com/invowk/invowk/main/scripts/install.ps1 | iex
-
WinGet:
winget upgrade Invowk.Invowk -
Homebrew:
brew upgrade invowk -
Go install:
go install github.com/invowk/invowk@latest -
Código-fonte: Atualize as últimas alterações e recompile:
git pull && make build && make install
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!