kosa8

oficial

Infraestrutura segura para agentes de IA: sandboxes de microVM isoladas que você pode criar checkpoints, retroceder e bifurcar.

GitHub

O que você pode fazer com kosa8 MCP?

Executar código em uma microVM isolada — Peça ao Claude para executar código não confiável ou gerado em uma microVM isolada que tenha acesso apenas à pasta do workspace.
Criar um checkpoint e reverter um sandbox — Salve um ponto de restauração que inclua a memória e os processos em execução e, em seguida, reverta para ele com os processos retomados.
Criar uma bifurcação de um sandbox em execução — Crie cópias independentes de um sandbox ativo para testar abordagens em paralelo e manter a que funcionar.
Restringir o tráfego de saída da rede — Crie um sandbox cuja rede alcance apenas os hosts da sua lista de permissões, recusando todo o restante.
Verificar o status do daemon — Peça ao Claude para verificar se o daemon kosa8 está em execução e informar sua versão.

Documentação

plugin kosa8 para Claude Code

kosa8: infraestrutura segura para agentes de IA.

Ofereça ao Claude uma máquina isolada para trabalhar. Este plugin conecta o Claude Code ao kosa8, infraestrutura segura para agentes de IA: cada agente recebe sua própria máquina isolada, uma microVM real com seu próprio kernel, e não um contêiner que compartilha o kernel do host.

Com o plugin ativado, Claude pode:

executar código não confiável ou escrito por agentes em uma microVM isolada que vê uma pasta (o espaço de trabalho) e nada mais no host;
trabalhar em uma rede fechada, na qual apenas os hosts de uma lista de permissões que você definir são acessíveis, e qualquer outra conexão é recusada;
usar chaves de API sem mantê-las: um intermediário de saída no host as injeta no caminho para fora, e a sandbox mantém apenas um espaço reservado;
criar um ponto de restauração da máquina em execução inteira, incluindo memória e processos, em cerca de 0,7 segundo antes de uma etapa arriscada e voltar a ele, ainda em execução, em cerca de um segundo quando algo dá errado;
bifurcar uma máquina em execução em cópias ativas para testar abordagens em paralelo e manter a que funciona;
aguardar a aprovação de uma ou duas pessoas identificadas em ações arriscadas (a regra das duas pessoas), com cada ação registrada em um log de auditoria encadeado por hash e à prova de adulteração.

O plugin tem quatro partes:

Um servidor MCP (.mcp.json) que inicia kosa8 mcp serve por meio de scripts/kosa8-mcp como um processo stdio local.
Uma skill (skills/kosa8-sandbox) que informa ao Claude quando recorrer a uma sandbox e como usar pontos de restauração, retorno, bifurcação, listas de permissões de saída e aprovações com segurança.
Comandos: /kosa8:status, /kosa8:sandbox <task>, /kosa8:checkpoint, /kosa8:rewind (pergunta antes de voltar a um ponto de restauração) e /kosa8:explore (testa vários comandos em bifurcações paralelas).
Agentes: sandbox-runner executa código não confiável ou gerado em uma microVM isolada e informa o que fez; fork-explorer compara abordagens em bifurcações paralelas de uma única sandbox em execução.

Pré-requisitos

Claude Code.
kosa8 instalado na mesma máquina, com kosa8 no seu PATH. kosa8 funciona em Macs com chip Apple e Linux x86-64, e no Windows por meio do WSL2 (prévia). Instale-o em kosa8.com/download. As versões são assinadas e notarizadas. Verifique a instalação com kosa8 version.
O daemon do kosa8 em execução. O plugin é apenas um iniciador: as sandboxes são microVMs executadas por kosa8d na sua máquina, então nada funciona até que ele esteja ativo.

Antes de começar: instale o kosa8 e inicie o daemon

O plugin não instala o kosa8 e não funciona sem ele. Em uma máquina nova:

# 1. Install kosa8 (macOS on Apple silicon, x86-64 Linux, or WSL2)
#    from https://kosa8.com/download/, then check it:
kosa8 version

# 2. Start the daemon that runs the microVMs:
kosa8 daemon start

# 3. Confirm both halves are up:
kosa8 version          # prints "kosa8 daemon <version> (up Ns)"
kosa8 mcp tools        # lists the tools this plugin exposes

Se kosa8 version informar kosa8 daemon: not running, execute kosa8 daemon start novamente. O servidor MCP inicia sem o daemon, mas todas as ferramentas de sandbox respondem então com cannot reach kosa8d.

Agentes que instalarem este servidor para um usuário podem seguir llms-install.md.

Instalação

No Claude Code, adicione este repositório como um marketplace e instale o plugin:

/plugin marketplace add kosa8ai/kosa8-claude-plugin
/plugin install kosa8@kosa8

Ou pelo shell:

claude plugin marketplace add kosa8ai/kosa8-claude-plugin
claude plugin install kosa8@kosa8

Reinicie o Claude Code (ou execute /reload-plugins). Execute /mcp para confirmar que o servidor kosa8 está conectado e peça ao Claude para "verificar o status do kosa8".

Compartilhamento de pastas do host

Por padrão, os agentes não podem compartilhar nenhum diretório do host com uma sandbox. Para permitir que compartilhem uma pasta de projeto, inicie o servidor com --allow-mount DIR (somente leitura) ou --allow-mount DIR:rw. Você pode fazer isso adicionando sua própria entrada de servidor MCP, por exemplo, no .mcp.json de um projeto:

{
  "mcpServers": {
    "kosa8-workspace": {
      "command": "kosa8",
      "args": ["mcp", "serve", "--allow-mount", "/Users/you/code/api:rw"]
    }
  }
}

Rede e chaves

O acesso à rede de uma sandbox é definido quando ela é criada. Para dar a uma sandbox acesso a uma API e a nada mais, crie-a pelo terminal:

kosa8 sandbox create sealed --egress-allow api.anthropic.com

Ferramentas

kosa8 mcp serve expõe estas ferramentas (conforme informado por kosa8 mcp tools no kosa8 0.5.0):

Ferramenta	O que faz
`kosa8_status`	Verifica se o daemon do kosa8 está em execução e informa sua versão
`sandbox_create`	Inicializa uma sandbox microVM isolada com kernel e mecanismo de contêiner próprios
`sandbox_list`	Lista as sandboxes, incluindo de qual sandbox pai cada bifurcação veio
`sandbox_run`	Executa um contêiner dentro do mecanismo privado da sandbox, isolado do host
`sandbox_pull`	Baixa uma imagem para o mecanismo privado da sandbox
`sandbox_checkpoint`	Salva um ponto de restauração, incluindo memória e processos em execução
`sandbox_checkpoint_list`	Lista os pontos de restauração de uma sandbox
`sandbox_rewind`	Retorna uma sandbox a um ponto de restauração, retomando os processos
`sandbox_fork`	Bifurca uma sandbox em execução em N cópias independentes
`sandbox_explore`	Melhor de N: bifurca uma vez por comando candidato, executa-os simultaneamente e mantém o vencedor
`sandbox_snapshot`	Captura o estado completo de uma sandbox como um snapshot
`sandbox_stop`	Para uma sandbox sem excluí-la
`sandbox_start`	Inicia uma sandbox parada a partir do próprio disco
`sandbox_delete`	Para e exclui uma sandbox e sua VM
`snapshot_list`	Lista os snapshots de sandbox salvos
`snapshot_restore`	Inicializa uma sandbox a partir de um snapshot, retomando seus processos
`snapshot_rm`	Exclui um snapshot
`container_run`	Executa um contêiner até a conclusão e retorna sua saída
`container_exec`	Executa um comando dentro de um contêiner em execução
`container_list`	Lista os contêineres
`container_logs`	Busca a saída de um contêiner
`container_stats`	Informa o uso de CPU, memória e pid de um contêiner
`container_stop`	Para um contêiner em execução
`image_build`	Cria uma imagem a partir de um Dockerfile em um diretório do host
`image_list`	Lista as imagens
`image_pull`	Baixa uma imagem de um registro
`network_create`	Cria uma rede de ponte isolada
`network_list`	Lista as redes de contêineres
`volume_create`	Cria um volume nomeado
`volume_list`	Lista os volumes nomeados

Execute kosa8 mcp tools para ver a lista da versão instalada.

O que este plugin executa

O único executável do plugin é scripts/kosa8-mcp, um script de shell curto que localiza o kosa8 já instalado na sua máquina e executa kosa8 mcp serve. Ele não baixa nem instala nada. O próprio plugin não envia dados a lugar algum, não contata nenhum servidor e não lê credenciais.

Outros clientes MCP

O mesmo servidor está publicado no Registro MCP oficial como io.github.kosa8ai/kosa8 (consulte server.json). Ele é distribuído como um pacote MCP, kosa8-mcp.mcpb, anexado a cada versão do GitHub: um manifesto e o mesmo iniciador curto que scripts/kosa8-mcp. Ele não baixa nem instala nada, então instale o kosa8 primeiro.

Qualquer cliente MCP que consiga iniciar um servidor stdio também pode executar kosa8 mcp serve diretamente.

Privacidade

O servidor MCP do kosa8 é executado localmente e se comunica com o daemon do kosa8 na mesma máquina. De acordo com a política de privacidade do kosa8, as chamadas de ferramenta feitas pelo seu agente, seus argumentos e resultados permanecem na sua máquina e nunca chegam ao kosa8. A política lista tudo o que o software kosa8 envia e quando, incluindo verificações de licença para licenças pagas, e como desativar todas as chamadas de saída com KOSA8_OFFLINE=1.

Política completa: https://kosa8.com/privacy/

Preços

O kosa8 é um software comercial. Os arquivos do plugin neste repositório são gratuitos e licenciados pelo MIT, mas o próprio kosa8 precisa de uma licença: ele inclui uma avaliação gratuita de 14 dias com todos os recursos, sem conta e sem cartão. Os planos começam em US$ 29 por mês. Consulte https://kosa8.com/pricing/.

Suporte e contato

E-mail: contact@kosa8.com
Problemas: https://github.com/kosa8ai/kosa8-claude-plugin/issues
Site: https://kosa8.com

Licença

Os arquivos deste repositório são distribuídos sob a Licença MIT. A licença cobre apenas os arquivos deste repositório (o plugin do Claude Code: seu manifesto, arquivo de marketplace, configuração MCP, skill, comandos, agentes, iniciador, README e logotipo). Ela não cobre o próprio software kosa8, que é um software comercial distribuído separadamente sob seus próprios termos.