Instalar o Konsolity CLI

Atualizado em 10 de novembro de 2026

O Konsolity CLI é o comando konsolity, para instalar num servidor ou numa máquina sem interface gráfica. Depois de ativado a partir da sua conta, ele dá acesso aos hosts, snippets e sessões do seu cofre dentro do escopo que você definiu, e funciona como servidor MCP local para os agentes Claude (o Claude Code, por exemplo). Ele funciona como o Claude Code na linha de comando: você o instala, ativa uma vez com um código e depois o utiliza.

Plano necessário

O Konsolity CLI é exclusivo do plano Studio e do seu teste gratuito. O servidor verifica o plano a cada chamada da máquina: sem ele, todos os comandos respondem “Assinatura necessária”. A lista de máquinas e a revogação continuam sempre acessíveis, mesmo sem o plano.

Escolher a máquina

Qualquer computador que alcance os seus hosts por SSH: um servidor de administração, uma pequena máquina virtual, um Mac mini, uma estação de desenvolvimento, um executor de CI. A máquina não precisa de nenhuma porta de entrada, apenas de acesso de saída em HTTPS para api.konsolity.com.

Sistema Arquiteturas Formatos
Linux (Debian, Ubuntu, Fedora, RHEL e derivados, qualquer distribuição pelo arquivo compactado) x64, arm64 script, .deb, .rpm, .tar.gz
macOS (Intel e Apple silicon) um arquivo por arquitetura (x64, arm64), binário assinado com Developer ID e notarizado · macOS 11 ou posterior script, Homebrew, .tar.gz
Windows x64 script PowerShell, .zip

Linux e macOS: script de instalação

O método mais simples. O script detecta o sistema e a arquitetura, baixa o arquivo certo, verifica o hash SHA-256 e a assinatura Ed25519 do editor e depois o instala:

curl -fsSL https://konsolity.com/cli/install.sh | sh

Para ler o script antes de executá-lo:

curl -fsSLO https://konsolity.com/cli/install.sh
less install.sh
sh install.sh

O script para sem instalar nada se o hash ou a assinatura não corresponderem.

Linux: pacote .deb (Debian, Ubuntu)

Baixe o pacote da sua arquitetura e depois:

sudo apt install ./konsolity_<version>_amd64.deb

Em arm64 (Raspberry Pi 4 ou 5, servidores Graviton ou Ampere), use konsolity_<version>_arm64.deb. As atualizações passam depois pelo apt.

Linux: pacote .rpm (Fedora, RHEL, Rocky, Alma)

sudo dnf install ./konsolity-<version>.x86_64.rpm

Em arm64, o arquivo termina em .aarch64.rpm. As atualizações passam depois pelo dnf.

Linux: arquivo .tar.gz

Para qualquer outra distribuição, o arquivo compactado contém apenas o binário:

tar -xzf konsolity_<version>_linux_amd64.tar.gz
sudo install -m 0755 konsolity /usr/local/bin/konsolity

Substitua amd64 por arm64 numa máquina ARM.

macOS: Homebrew

brew install konsolity/tap/konsolity

As atualizações passam depois por brew upgrade konsolity. O script de instalação e o arquivo konsolity-<version>-macos-x64.tar.gz (Intel) / konsolity-<version>-macos-arm64.tar.gz (Apple silicon) também funcionam.

Windows: PowerShell

No PowerShell (sem direitos de administrador):

irm https://konsolity.com/cli/install.ps1 | iex

O script faz as mesmas verificações que no Linux, instala o konsolity.exe no seu perfil e o adiciona ao PATH do usuário. Abra um novo terminal para usá-lo.

Windows: arquivo .zip

O arquivo konsolity_<version>_windows_amd64.zip contém o konsolity.exe. Extraia-o numa pasta da sua escolha e depois adicione essa pasta ao seu PATH.

Verificar um download

Cada versão é descrita pelo manifesto assinado https://konsolity.com/cli/latest.json: versão, lista de arquivos (sistema, arquitetura, formato, endereço, hash SHA-256) e assinatura Ed25519 do editor. Os scripts e o konsolity update recusam um arquivo cujo hash ou assinatura não corresponda. Para verificar você mesmo um pacote baixado manualmente:

curl -fsSL https://konsolity.com/cli/latest.json
sha256sum konsolity_<version>_amd64.deb

No macOS, use shasum -a 256; no Windows, Get-FileHash konsolity_<version>_windows_amd64.zip. O hash exibido deve ser exatamente o do manifesto.

Verificar a instalação

konsolity version

O comando exibe a versão, o sistema e a arquitetura.

Atualizar

konsolity update

O konsolity update lê o manifesto, verifica o hash e a assinatura da nova versão e depois substitui o binário. Se o konsolity foi instalado pelo apt, pelo dnf ou pelo Homebrew, o comando indica esse gerenciador de pacotes em vez de substituir o arquivo por conta própria.

Se o serviço systemd estiver instalado, execute sudo konsolity update: atualiza /usr/local/bin/konsolity e depois reinicia o serviço. O temporizador konsolity-update.timer também o faz sozinho duas vezes por dia.

Próximos passos

  1. Ativar a máquina com um código aprovado a partir da sua conta.
  2. Escolher o escopo: hosts, snippets, regras de comando.
  3. Conhecer os comandos, conectar o Claude Code ou executá-lo como serviço.