Instalação direta

A instalação direta usa o executável nativo do Raims CLI. Esse canal não exige Node.js nem npm. O instalador consulta o canal de distribuição pela internet, verifica os arquivos e grava a instalação em uma pasta do usuário, sem pedir uma chave de API.

Para instalar pelo npm em uma automação, siga CI e automação, que usa @latest.

Escolher o instalador

Escolha o sistema e a arquitetura da máquina onde o CLI será executado:

0.1.2 identifica a versão do instalador. Ao consultar o canal, ele seleciona o patch estável mais recente da linha 0.1. O nome do arquivo não fixa a versão do CLI que será instalada. Confira a versão apresentada no plano.

No Windows ARM64, escolha o instalador ARM64 para executar o CLI nativo. Essa instalação direta não exige Node.js. Para conferir a arquitetura de uma instalação existente, consulte Diagnóstico.

No Windows, você pode conferir a assinatura digital do arquivo com Get-AuthenticodeSignature. Se o resultado não for Valid, não execute o arquivo e confira o download oficial.

Conferir o plano e instalar

Sem -apply, o instalador consulta o canal e mostra a versão e o destino, sem aplicar a instalação. Execute novamente com -apply depois de conferir o plano. Os exemplos abaixo baixam o instalador e usam o destino padrão.

Invoke-WebRequest -Uri 'https://static.raims.com/cli/direct/installers/0.1.2/raims-install-0.1.2-windows-amd64.exe' -OutFile '.\raims-install-0.1.2-windows-amd64.exe'
.\raims-install-0.1.2-windows-amd64.exe
.\raims-install-0.1.2-windows-amd64.exe -apply

-directory CAMINHO escolhe outro destino absoluto dentro do espaço do usuário. A pasta precisa ser gravável e não pode ser acessada por links ou junctions. O instalador não eleva permissões nem substitui arquivos desconhecidos ou uma instalação de outra versão. Uma repetição exata reutiliza a instalação e preserva arquivos adicionais.

Usar o executável instalado

Os destinos padrão são:

Você pode usar o caminho completo, sem alterar PATH:

& "$env:LOCALAPPDATA\Raims\CLI\raims.exe" version
& "$env:LOCALAPPDATA\Raims\CLI\raims.exe" update status

Se escolheu outro destino, use o executável nessa pasta. A instalação não cria um perfil nem guarda a chave de API. Para fazer requisições, siga Configuração e perfis.

Criar um comando no PATH

-link-user-path é uma escolha explícita e exige -apply e -path-directory CAMINHO. Esse diretório precisa existir no espaço do usuário e já fazer parte do PATH da sessão. O instalador não edita perfis de shell, registro ou o valor do PATH.

No exemplo abaixo, use ~/.local/bin somente se essa pasta já existir e estiver no PATH:

./raims-install -apply -link-user-path -path-directory "$HOME/.local/bin"
raims version

No Windows, as mesmas opções recebem um diretório do usuário já presente no PATH. WindowsApps não é aceito como destino dessa integração.

Resolva conflitos com outras instalações, aliases ou funções do shell antes de criar a entrada. O instalador recusa um comando anterior no PATH ou uma entrada conflitante no diretório escolhido. Se a integração falhar, a instalação verificada é preservada; use o caminho completo do executável.

Controlar as atualizações

Na instalação direta, o CLI pode consultar atualizações silenciosamente enquanto é usado. Uma versão baixada fica pendente e pode ser ativada na próxima execução elegível, sem interromper o comando que já estava rodando. Se a consulta ou a verificação falhar, a versão instalada é preservada.

raims update status mostra a política e as versões locais, sem buscar uma atualização. RAIMS_CLI_NO_UPDATE=1 desativa consultas e ativações pendentes; não reverte uma versão já ativa.

RAIMS_CLI_PIN_VERSION exige uma versão que já esteja instalada ou conservada pelo CLI. O pin não baixa uma versão. Ambientes de CI desativam consultas e ativações automáticas. Nos exemplos de instalação por npm, inclusive em CI, use @latest. Veja como derivar o pin da instalação direta em CI e automação.

Conservar versões e backups

Preserve as versões em cache, a instalação original e os backups do CLI. Esses arquivos permitem selecionar versões conservadas e recuperar uma instalação. Não há limpeza automática do histórico nesta entrega.

Não apague versões enquanto houver comandos em execução. Uma falha de um comando que já iniciou não faz o CLI repeti-lo automaticamente.

Consultar avisos e licenças

raims licenses lê os textos incluídos na versão em execução, sem perfil, chave ou rede. A saída JSON contém text e sha256. Veja os exemplos em Avisos e licenças.