kosa8

oficial

Infraestructura segura para agentes de IA: entornos aislados de microVM sellados que puedes guardar como puntos de control, rebobinar y bifurcar.

GitHub

¿Qué puedes hacer con kosa8 MCP?

Ejecutar código en una microVM aislada — Pide a Claude que ejecute código no confiable o generado en una microVM aislada que solo tenga acceso a la carpeta del espacio de trabajo.
Crear un punto de control y restaurar un entorno aislado — Guarda un punto de restauración que incluya la memoria y los procesos en ejecución; luego, vuelve a ese punto con los procesos reanudados.
Bifurcar un entorno aislado en ejecución — Bifurca un entorno aislado activo en copias independientes para probar distintos enfoques en paralelo y conservar el que funcione.
Restringir el tráfico de salida de la red — Crea un entorno aislado cuya red solo pueda acceder a los hosts de tu lista de permitidos y rechace todo lo demás.
Comprobar el estado del daemon — Pide a Claude que compruebe si el daemon kosa8 está en ejecución e informe de su versión.

Documentación

Plugin kosa8 para Claude Code

kosa8: infraestructura segura para agentes de IA.

Proporciona a Claude una máquina aislada en la que trabajar. Este plugin conecta Claude Code con kosa8, infraestructura segura para agentes de IA: cada agente obtiene su propia máquina aislada, una microVM real con su propio kernel, no un contenedor que comparte el kernel del host.

Con el plugin habilitado, Claude puede:

ejecutar código no confiable o escrito por agentes en una microVM aislada que solo ve una carpeta (el espacio de trabajo) y nada más del host;
trabajar con una red cerrada, donde solo se puede acceder a los hosts de una lista de permitidos que tú escribes y cualquier otro intento de conexión se rechaza;
usar claves de API sin tenerlas en su poder: un intermediario de salida en el host las inyecta al salir, y el entorno aislado solo contiene un marcador de posición;
crear un punto de control de toda la máquina en ejecución, incluida la memoria y los procesos, en unos 0.7 segundos antes de un paso arriesgado, y volver a él, todavía en ejecución, en aproximadamente un segundo si algo sale mal;
bifurcar una máquina en ejecución en copias activas para probar enfoques en paralelo y conservar el que funcione;
esperar la aprobación de una o dos personas designadas para acciones arriesgadas (la regla de las dos personas), y registrar cada acción en un registro de auditoría encadenado mediante hashes y a prueba de manipulaciones.

El plugin tiene cuatro componentes:

Un servidor MCP (.mcp.json) que inicia kosa8 mcp serve mediante scripts/kosa8-mcp como proceso local de stdio.
Una skill (skills/kosa8-sandbox) que indica a Claude cuándo recurrir a un entorno aislado y cómo usar de forma segura los puntos de control, la reversión, las bifurcaciones, las listas de permitidos de salida y las aprobaciones.
Comandos: /kosa8:status, /kosa8:sandbox <task>, /kosa8:checkpoint, /kosa8:rewind (pregunta antes de volver a un punto anterior) y /kosa8:explore (prueba varios comandos en bifurcaciones paralelas).
Agentes: sandbox-runner ejecuta código no confiable o generado en una microVM aislada e informa de lo que hizo; fork-explorer compara enfoques en bifurcaciones paralelas de un mismo entorno aislado en ejecución.

Requisitos previos

Claude Code.
kosa8 instalado en la misma máquina, con kosa8 en tu PATH. kosa8 funciona en Mac con chip de Apple y Linux x86-64, y en Windows mediante WSL2 (versión preliminar). Instálalo desde kosa8.com/download. Las versiones están firmadas y notarizadas. Comprueba la instalación con kosa8 version.
El daemon de kosa8 en ejecución. El plugin es solo un lanzador: los entornos aislados son microVM ejecutadas por kosa8d en tu máquina, así que nada funcionará hasta que esté activo.

Antes de empezar: instala kosa8 e inicia el daemon

El plugin no instala kosa8 y no puede ejecutarse sin él. En una máquina nueva:

# 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

Si kosa8 version indica kosa8 daemon: not running, vuelve a ejecutar kosa8 daemon start. El servidor MCP se inicia sin el daemon, pero entonces todas las herramientas de entornos aislados responden cannot reach kosa8d.

Los agentes que instalen este servidor para un usuario pueden seguir llms-install.md.

Instalación

En Claude Code, añade este repositorio como marketplace e instala el plugin:

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

O desde tu shell:

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

Reinicia Claude Code (o ejecuta /reload-plugins). Ejecuta /mcp para confirmar que el servidor kosa8 está conectado y pídele a Claude que «compruebe el estado de kosa8».

Compartir carpetas del host

De forma predeterminada, los agentes no pueden compartir ningún directorio del host con un entorno aislado. Para permitirles compartir una carpeta del proyecto, inicia el servidor con --allow-mount DIR (solo lectura) o --allow-mount DIR:rw. Puedes hacerlo añadiendo tu propia entrada de servidor MCP, por ejemplo, en el archivo .mcp.json de un proyecto:

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

Red y claves

El acceso a la red de un entorno aislado se establece al crearlo. Para dar acceso a un entorno aislado a una API y a nada más, créalo desde tu terminal:

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

Herramientas

kosa8 mcp serve expone estas herramientas (según informa kosa8 mcp tools en kosa8 0.5.0):

Herramienta	Qué hace
`kosa8_status`	Comprueba si el daemon de kosa8 está en ejecución e informa de su versión
`sandbox_create`	Inicia un entorno aislado de microVM con su propio kernel y motor de contenedores
`sandbox_list`	Enumera los entornos aislados, incluido el entorno principal del que procede cada bifurcación
`sandbox_run`	Ejecuta un contenedor dentro del motor privado de un entorno aislado, separado del host
`sandbox_pull`	Descarga una imagen en el motor privado de un entorno aislado
`sandbox_checkpoint`	Guarda un punto de restauración, incluida la memoria y los procesos en ejecución
`sandbox_checkpoint_list`	Enumera los puntos de restauración de un entorno aislado
`sandbox_rewind`	Devuelve un entorno aislado a un punto de control y reanuda sus procesos
`sandbox_fork`	Bifurca un entorno aislado en ejecución en N copias independientes
`sandbox_explore`	Mejor de N: crea una bifurcación por cada comando candidato, los ejecuta simultáneamente y conserva el ganador
`sandbox_snapshot`	Captura el estado completo de un entorno aislado como instantánea
`sandbox_stop`	Detiene un entorno aislado sin eliminarlo
`sandbox_start`	Inicia un entorno aislado detenido desde su propio disco
`sandbox_delete`	Detiene y elimina un entorno aislado y su VM
`snapshot_list`	Enumera las instantáneas guardadas de los entornos aislados
`snapshot_restore`	Inicia un entorno aislado desde una instantánea y reanuda sus procesos
`snapshot_rm`	Elimina una instantánea
`container_run`	Ejecuta un contenedor hasta que finaliza y devuelve su salida
`container_exec`	Ejecuta un comando dentro de un contenedor en ejecución
`container_list`	Enumera los contenedores
`container_logs`	Obtiene la salida de un contenedor
`container_stats`	Informa del uso de CPU, memoria y PID de un contenedor
`container_stop`	Detiene un contenedor en ejecución
`image_build`	Crea una imagen a partir de un Dockerfile en un directorio del host
`image_list`	Enumera las imágenes
`image_pull`	Descarga una imagen de un registro
`network_create`	Crea una red puente aislada
`network_list`	Enumera las redes de contenedores
`volume_create`	Crea un volumen con nombre
`volume_list`	Enumera los volúmenes con nombre

Ejecuta kosa8 mcp tools para ver la lista correspondiente a tu versión instalada.

Qué ejecuta este plugin

El único ejecutable del plugin es scripts/kosa8-mcp, un breve script de shell que encuentra la instalación de kosa8 que ya tienes en tu máquina y ejecuta kosa8 mcp serve. No descarga ni instala nada. El plugin no envía datos a ningún sitio, no se conecta a ningún servidor ni lee credenciales.

Otros clientes MCP

El mismo servidor está publicado en el registro oficial de MCP como io.github.kosa8ai/kosa8 (consulta server.json). Se distribuye como un paquete MCP, kosa8-mcp.mcpb, adjunto a cada lanzamiento de GitHub: un manifiesto y el mismo lanzador breve que scripts/kosa8-mcp. No descarga ni instala nada, así que instala kosa8 primero.

Cualquier cliente MCP que pueda iniciar un servidor de stdio también puede ejecutar kosa8 mcp serve directamente.

Privacidad

El servidor MCP de kosa8 se ejecuta localmente y se comunica con el daemon de kosa8 en la misma máquina. Según la política de privacidad de kosa8, las llamadas a herramientas que realiza tu agente, sus argumentos y sus resultados permanecen en tu máquina y nunca llegan a kosa8. La política enumera todo lo que envía el software de kosa8 y cuándo lo hace, incluidas las comprobaciones de licencia para las licencias de pago, y explica cómo desactivar todas las llamadas salientes con KOSA8_OFFLINE=1.

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

Precios

kosa8 es software comercial. Los archivos del plugin de este repositorio son gratuitos y tienen licencia MIT, pero kosa8 requiere una licencia: incluye una prueba gratuita de 14 días con todas las funciones, sin cuenta ni tarjeta. Los planes empiezan en $29 al mes. Consulta https://kosa8.com/pricing/.

Soporte y contacto

Correo electrónico: contact@kosa8.com
Incidencias: https://github.com/kosa8ai/kosa8-claude-plugin/issues
Sitio web: https://kosa8.com

Licencia

Los archivos de este repositorio se distribuyen bajo la Licencia MIT. La licencia solo cubre los archivos de este repositorio (el plugin de Claude Code: su manifiesto, archivo de marketplace, configuración MCP, skill, comandos, agentes, lanzador, README y logotipo). No cubre el propio software kosa8, que es software comercial distribuido por separado bajo sus propios términos.