Instalação

Instale, verifique, atualize ou desinstale o Clarvis v0.1.1.

O download portátil inclui tudo que o Clarvis precisa para funcionar, inclusive Bun e as dependências nativas da interface de terminal. Você não precisa instalar Bun, Node.js, compilador ou gerenciador de pacotes. Também não precisa de acesso de administrador nem de uma cópia do código-fonte.

A v0.1.1 é uma release pública oficial 0.x. Interfaces e formatos persistidos ainda podem mudar antes da 1.0, e seus binários ainda não têm assinatura de código nem notarização.

Os comandos desta página usam a versão v0.1.1. Baixe o pacote, o instalador e o arquivo de verificação da mesma versão.

Versão atual

A Clarvis v0.1.1 é publicada no repositório público exclusivo para binários getclarvis/clarvis-releases. A release contém os seis arquivos portáteis, instaladores versionados para POSIX e PowerShell, o SHA256SUMS e os avisos de licença aplicáveis.

Sistemas compatíveis

Sistema operacional	Arquiteturas	Alvo do arquivo	Verificações automatizadas
Linux (glibc)	x64, arm64	linux-x64, linux-arm64	Pacote, instalação e primeira tela no terminal
macOS	Intel, Apple silicon	darwin-x64, darwin-arm64	Pacote, instalação e primeira tela no terminal
Windows	x64, arm64	windows-x64, windows-arm64	Pacote, instalação e comandos básicos da CLI

As verificações de lançamento cobrem o pacote e a instalação nos seis alvos, além de confirmar que os pacotes públicos não incluem source maps. No Linux e no macOS, elas também verificam a primeira tela em um pseudoterminal (PTY). No Windows, verificam o manifesto, --version, --help, instalação e reinstalação. Esses testes não substituem abrir a interface do Windows manualmente nem verificar os avisos do SmartScreen. Para executar sem interface interativa, use clarvis -p.

Linux e macOS

Os pré-requisitos são tar, mktemp, curl e sha256sum ou shasum. Os arquivos para Linux têm como alvo sistemas GNU/glibc; Alpine e outras distribuições exclusivas de musl não são compatíveis com esses artefatos portáteis.

Instale a versão publicada com:

curl -fsSL https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.sh | sh

Para inspecionar o instalador antes da execução, baixe o mesmo arquivo da versão publicada, revise-o localmente e só então execute:

curl -fL https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.sh -o install.sh
vi ./install.sh
sh ./install.sh

A instalação gerenciada fica, por padrão, em ${XDG_DATA_HOME:-$HOME/.local/share}/clarvis. Um pequeno inicializador é colocado em ${CLARVIS_BIN_DIR:-${XDG_BIN_HOME:-$HOME/.local/bin}}/clarvis. O instalador não edita perfis do shell. Se o diretório resolvido do inicializador não estiver no PATH, ele mostra a linha apropriada para adicioná-lo, e pode ser necessário abrir um novo shell.

Windows PowerShell

O Windows exige PowerShell com Invoke-RestMethod (irm), Invoke-Expression (iex), Invoke-WebRequest, Get-FileHash e o tar.exe do sistema.

Instale a versão publicada com:

irm "https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.ps1" | iex

Para inspecionar o instalador primeiro, baixe e revise o mesmo arquivo da versão publicada:

Invoke-WebRequest -Uri "https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.ps1" -OutFile ".\install.ps1"
notepad .\install.ps1
& .\install.ps1

A instalação gerenciada usa %LOCALAPPDATA%\Clarvis por padrão. O diretório bin é adicionado ao PATH do usuário, a menos que CLARVIS_SKIP_PATH=1 esteja definido. Reabra o terminal se o comando clarvis não for encontrado imediatamente.

O que o instalador verifica

Para o sistema operacional e a arquitetura detectados, o instalador:

1. baixa o arquivo compactado .tar.gz versionado do alvo e o SHA256SUMS da mesma release;
2. exige uma única entrada exata de checksum e verifica os bytes baixados;
3. extrai o conteúdo em um diretório de preparação privado;
4. verifica se a CLI preparada informa a versão solicitada;
5. recusa substituir um comando não relacionado ou um inicializador POSIX pertencente a outra raiz de instalação;
6. ativa a nova versão somente depois que todas as verificações passam.

O instalador mostra a versão selecionada, o alvo detectado, os destinos resolvidos e uma linha de status numerada antes de cada etapa de download, checksum, extração, teste da CLI antes de ativar e ativação.

Cada arquivo compactado também contém um manifesto interno release.json com o caminho, o tamanho e o SHA-256 exatos de cada item. O Clarvis verifica esse manifesto novamente antes de ativar uma atualização.

Para verificar manualmente o arquivo compactado, baixe-o com o SHA256SUMS, isole a linha cujo nome corresponde exatamente ao arquivo e use a ferramenta SHA-256 da plataforma. Não instale um artefato se o nome ou o código de verificação forem diferentes.

Executar e atualizar

clarvis --version
cd /caminho/do/projeto
clarvis
clarvis --update

O atualizador funciona apenas em uma instalação portátil gerenciada. Ele não é executado automaticamente na inicialização. O atualizador prepara e verifica a versão candidata, preserva a versão anterior e altera a versão ativa por último. Checkouts do código-fonte e instalações feitas com bun link recusam intencionalmente a atualização automática. Atualize esses ambientes pelo Git e pelo fluxo de desenvolvimento.

Uma versão de pré-lançamento pode avançar para uma versão de pré-lançamento mais recente ou para a versão estável posterior. Uma instalação estável não seleciona versões de pré-lançamento.

Binários sem assinatura

Os binários da v0.1.1 não têm assinatura de código nem notarização. O Gatekeeper do macOS ou o SmartScreen do Windows podem pedir confirmação para um aplicativo baixado. Leia o aviso da plataforma, confirme a URL da release e o SHA-256 e siga a interface normal de aprovação do sistema operacional. Os instaladores do Clarvis não desativam nem contornam as proteções da plataforma.

Remover o Clarvis

Os instaladores públicos da v0.1.1 têm um modo explícito de desinstalação protegida. Baixe o instalador da mesma versão publicada antes de executar o comando de remoção.

Linux ou macOS:

curl -fL https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.sh -o install.sh
sh ./install.sh --uninstall

Windows PowerShell:

Invoke-WebRequest -Uri "https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.ps1" -OutFile ".\install.ps1"
& .\install.ps1 -Uninstall

O desinstalador mostra o que será removido e verifica se os arquivos pertencem à instalação selecionada do Clarvis. Ele usa o mesmo bloqueio exclusivo da instalação e da atualização, e recusa arquivos de outro programa ou que estejam sendo alterados ao mesmo tempo. No POSIX, o inicializador precisa apontar para a pasta de instalação selecionada.

Ele remove as versões gerenciadas, current, o marcador de instalação e o inicializador correspondente. No Windows, também remove a entrada bin gerenciada do PATH do usuário, mesmo que o inicializador já esteja ausente. Defina CLARVIS_SKIP_PATH=1 para manter o PATH inalterado.

Diretórios gerenciados que sejam links e destinos de marcador ou ativação que não sejam arquivos são recusados. Cancelar libera o bloqueio antes de sair. Arquivos desconhecidos e inicializadores de outros programas são preservados e informados. Repetir a desinstalação termina sem alterações, mesmo que esses arquivos preservados continuem lá.

As configurações e credenciais do usuário usam ~/.clarvis (ou %USERPROFILE%\.clarvis) por padrão e ficam separadas do binário gerenciado. Remover o aplicativo não apaga esse estado. Exclua-o somente depois de fazer backup do necessário e confirmar que as credenciais de provedores e sessões armazenadas não são mais necessárias.

Se os caminhos de instalação foram substituídos, passe os mesmos valores de CLARVIS_INSTALL_ROOT e, no POSIX, CLARVIS_BIN_DIR para o desinstalador público versionado. As variáveis estão documentadas nos arquivos install.sh e install.ps1 publicados.