Instalar o Konsolity CLI
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
- Ativar a máquina com um código aprovado a partir da sua conta.
- Escolher o escopo: hosts, snippets, regras de comando.
- Conhecer os comandos, conectar o Claude Code ou executá-lo como serviço.