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 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

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

PowerShell (Windows)

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

WinGet (Windows)

Instale usando WinGet no Windows 10/11:

winget install Invowk.Invowk

Para atualizar depois:

winget upgrade Invowk.Invowk

Homebrew

Se você usa Homebrew no macOS ou Linux:

brew install invowk/tap/invowk

Para atualizar depois:

brew upgrade invowk

Go Install

Se você tem Go 1.26+ instalado:

go install github.com/invowk/invowk@latest

O binário é instalado em $GOBIN (ou $GOPATH/bin).

Código-Fonte

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!