Ir para o conteúdo

// 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.

Linux e macOScurl -fsSL https://konsolity.com/cli/install.sh | sh
Windows (PowerShell)irm https://konsolity.com/cli/install.ps1 | iex
Homebrewbrew install konsolity/tap/konsolity

Pacotes .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.

1

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.

2

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.

3

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.

4

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 mcp

Com 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 loginAtiva a máquina com um código aprovado a partir da sua conta.
konsolity statusConta, máquina, âmbito, validade, idade do token e hosts acessíveis.
konsolity hostsLista 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 · runLista os snippets ou executa um num host.
konsolity sessions [--follow]Acompanha as sessões CLI em curso na conta ou termina uma.
konsolity mcpServidor MCP local (stdio) para o Claude.
konsolity serveRecolhe a fila do conector do Claude, como serviço do sistema.
konsolity setup-tokenToken de longa duração para uma CI ou um contentor, mostrado uma única vez.
konsolity updateAtualiza o binário depois de verificar a assinatura.
konsolity logoutRevoga 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.

Teste gratuito de 7 dias Guia de instalação Conector Claude

// 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.