// konsolity cli
O Konsolity na linha de comandos, nos seus servidores.
Como o Claude Code num terminal: o binário konsolity instala-se com uma linha num servidor Linux, num Mac ou no Windows, ativa-se com um código aprovado a partir da sua conta e depois dá acesso aos hosts, snippets e sessões que lhe confia. Também serve de servidor MCP local para os agentes do Claude.
// instalação
Uma linha para instalar.
Linux x64 e arm64, macOS em Intel e Apple silicon, Windows x64. Os instaladores verificam a soma SHA-256 e a assinatura do editor antes de instalar o que quer que seja.
curl -fsSL https://konsolity.com/cli/install.sh | shirm https://konsolity.com/cli/install.ps1 | iexbrew install konsolity/tap/konsolityPacotes .deb e .rpm para Debian, Ubuntu, Fedora, RHEL e derivadas, arquivos .tar.gz e .zip, com a respetiva soma SHA-256: Download
// ativação
Ativada com um código, nunca com uma palavra-passe.
Nunca se escreve nenhuma palavra-passe nem nenhuma chave na máquina.
Execute konsolity login
O comando mostra um endereço, um código XXXX-XXXX e a impressão digital da máquina, com um código QR se o terminal o permitir.
Aprove a partir da sua conta
Introduza o código no app (Configurações, Máquinas CLI) ou abra app.konsolity.com/cli/activate, e verifique se a impressão digital é a mesma do terminal.
Escolha o âmbito
Hosts, snippets, sessões, MCP; só leitura ou acesso completo; regras de comandos; validade de um dia a um ano, ou sem fim.
Confirme com um segundo fator
Código de autenticação de dois fatores ou chave de acesso, na mesma aprovação. Sem segundo fator na conta, nenhuma máquina pode ser ativada.
$ konsolity login --name web-01
https://app.konsolity.com/cli/activate
code KQ7M-4TZP
fingerprint 9F3A-C21D
$ konsolity status// âmbito
A máquina só vê o que lhe confia.
O âmbito escolhe-se na ativação e altera-se depois na página Máquinas CLI. Alargá-lo exige um segundo fator; reduzi-lo é imediato.
Hosts
Os hosts escolhidos, as suas identidades e as suas chaves de host fixadas. Um host fora do âmbito nunca é copiado para a máquina.
Snippets
Os snippets escolhidos, para listar ou executar num host do âmbito.
Sessões
As sessões CLI em curso na conta, para acompanhar ou terminar.
MCP
O servidor MCP local para o Claude Code e os agentes do Claude, e a fila do conector do Claude com konsolity serve.
Só leitura ou acesso completo
Em só leitura, a máquina lista e mostra o estado sem executar nenhum comando. Com acesso completo, executa o que as suas regras permitem.
Regras de comandos
Padrões permitidos (exato, prefixo ou glob) e duração máxima. O servidor e a máquina recusam ambos o que não é permitido.
// segurança
Um cofre de máquina, cifrado de ponta a ponta.
O Konsolity CLI mantém o modelo do Konsolity: o servidor não lê os seus hosts, as suas chaves nem as suas regras.
A chave do cofre fica nos seus dispositivos
A máquina nunca recebe a chave do seu cofre. O dispositivo que aprova entrega-lhe uma chave de máquina selada só para ela e, depois, cópias cifradas apenas dos elementos autorizados.
Ligada à máquina
O token está ligado à impressão digital da máquina: copiado para outro lugar, é recusado e recebe um alerta. Os segredos locais são cifrados com uma chave própria da máquina.
Rotação automática
O token é renovado automaticamente a cada 24 horas, sem interrupção do serviço.
Revogação em menos de 5 segundos
Revogue uma máquina ou termine uma sessão a partir do app ou da sua conta: ligações cortadas, comando parado, segredos locais apagados.
Comandos destrutivos confirmados
rm -rf, DROP, reboot, terraform destroy e os outros comandos destrutivos aguardam a sua aprovação no app, seja qual for o âmbito. Sem resposta em 5 minutos, nada é executado.
Tudo fica registado
Ativação, cada comando e o seu código de saída, confirmações, rotações, revogação. Nunca a saída nem um segredo. Exportação em CSV ou JSON.
Alertas
Nova máquina, impressão digital diferente, revogação, pedido de confirmação: por e-mail, no app e no Telegram, se o tiver ligado.
Segundo fator obrigatório
Ativar uma máquina ou alargar o seu âmbito exige um código de autenticação de dois fatores ou uma chave de acesso.
// mcp
Um servidor MCP local para o Claude.
konsolity mcp dá ao Claude Code e aos agentes do Claude as ferramentas list_hosts, list_snippets, run_command, run_snippet e list_sessions, com o mesmo âmbito, as mesmas regras e as mesmas confirmações. Basta uma linha para o ligar.
$ claude mcp add konsolity -- konsolity mcpCom konsolity serve, a máquina também recolhe a fila do conector do Claude da sua conta, como faz o app de computador, sem que este tenha de estar aberto. Conector Claude
// comandos
Os principais comandos.
konsolity login | Ativa a máquina com um código aprovado a partir da sua conta. |
konsolity status | Conta, máquina, âmbito, validade, idade do token e hosts acessíveis. |
konsolity hosts | Lista os hosts do âmbito, sem nenhum segredo. |
konsolity run <host> -- <command> | Executa um comando por SSH num host, com a saída em direto e o código de saída transmitido. |
konsolity snippet list · run | Lista os snippets ou executa um num host. |
konsolity sessions [--follow] | Acompanha as sessões CLI em curso na conta ou termina uma. |
konsolity mcp | Servidor MCP local (stdio) para o Claude. |
konsolity serve | Recolhe a fila do conector do Claude, como serviço do sistema. |
konsolity setup-token | Token de longa duração para uma CI ou um contentor, mostrado uma única vez. |
konsolity update | Atualiza o binário depois de verificar a assinatura. |
konsolity logout | Revoga a máquina e apaga tudo localmente. |
// studio
Incluído no plano Studio.
O Studio custa 99 € por mês ou 999 € por ano. O Konsolity CLI está reservado ao Studio e ao seu teste gratuito de 7 dias, como o conector do Claude. O servidor verifica o plano em cada chamada da máquina.
// faq
Perguntas frequentes
O servidor do Konsolity pode ler o que a máquina recebe?
Não. Os elementos copiados para a máquina são cifrados com uma chave de máquina que só os seus dispositivos e a máquina conhecem. O servidor guarda apenas blocos opacos, e a máquina nunca recebe a chave do seu cofre.
E se a máquina for roubada ou comprometida?
Revogue-a na página Máquinas CLI: fica desligada em menos de 5 segundos e as suas cópias são apagadas do servidor. Só os hosts do seu âmbito são afetados; por precaução, mude as respetivas chaves SSH.
É preciso manter o app aberto?
Não. A máquina trabalha sozinha dentro do seu âmbito. O app serve para a ativar, alterar o seu âmbito e confirmar os comandos destrutivos, e pode estar no seu telemóvel.
Que sistemas são suportados?
Linux x64 e arm64 (Debian, Ubuntu, Fedora, RHEL e derivadas, ou qualquer distribuição através do arquivo), macOS em Intel e Apple silicon, e Windows x64.
Posso usá-lo numa CI ou num contentor?
Sim, com konsolity setup-token: um token de longa duração, mostrado uma única vez, a guardar no seu gestor de segredos e a fornecer através de KONSOLITY_TOKEN. Tem um âmbito, um registo e uma revogação, como uma máquina.
De que plano preciso?
Studio, com o teste gratuito de 7 dias incluído. Ativar uma máquina exige também a autenticação de dois fatores ou uma chave de acesso na conta.