Registro de comandos

Atualizado em 10 de novembro de 2026

Cada ação de uma máquina CLI deixa um rastro no seu registro: ativação, lista de hosts, execução, snippet, ferramenta MCP, confirmação, rotação, desconexão, revogação. Ele pode ser consultado em Configurações › Máquinas CLI, abrindo a máquina, e em https://app.konsolity.com/cli-machines.

Início e fim

Para uma execução, a CLI grava uma linha antes de executar o comando e uma segunda no final, com o código de retorno e a duração. Se a gravação do início falhar (rede caída, servidor inacessível), o comando não é executado: nada roda sem deixar rastro.

O próprio servidor grava os eventos que dizem respeito a ele: ativação, rotação do token, revogação, confirmações, recusas de escopo.

Conteúdo de uma linha

  • Quando: a data e a hora;
  • Qual ferramenta: hosts, run, snippet, sessions, mcp:<tool>, serve:<tool>, login, rotate, logout;
  • Qual host: o rótulo dele;
  • Qual comando: o texto dele, limitado a 4.000 caracteres;
  • Decisão: permitido (com a regra que o permitiu), negado, confirmado ou recusado na confirmação;
  • Código de retorno e duração da execução;
  • a sessão CLI e, quando for o caso, a solicitação de confirmação.

O que o registro não contém

Nunca a saída do comando. Nunca uma senha, uma chave, um token ou uma chave de máquina.

Retenção

As linhas são criptografadas em repouso e mantidas por 90 dias, depois excluídas. Revogar uma máquina não exclui o registro dela: ele continua disponível até o fim dos 90 dias.

Filtros

Filtre por máquina (na página de máquinas), por período (de, até) e por decisão (permitida, recusada, confirmada, não confirmada): as linhas mais recentes aparecem primeiro e “Linhas mais antigas” carrega o restante. A exportação usa os mesmos filtros.

Exportação

Exportar gera um arquivo CSV (planilha, cabeçalhos em inglês) ou JSON (ferramentas, arquivamento) para o período escolhido. Guarde uma exportação mensal se precisar manter um rastro além de 90 dias.

Boas práticas

  • Revise o registro depois de ampliar um escopo: as recusas mostram o que foi tentado.
  • Uma recusa repetida de um comando legítimo indica uma regra a adicionar; uma recusa inesperada, uma solicitação a examinar.
  • Uma linha de início sem linha de fim indica um comando interrompido (revogação, encerramento de sessão, queda).