kosa8

officiel

Infrastructure sécurisée pour les agents IA : des environnements sandbox microVM scellés que vous pouvez sauvegarder sous forme de points de contrôle, rembobiner et dupliquer.

GitHub

Que pouvez-vous faire avec kosa8 MCP ?

Exécuter du code dans une microVM isolée — Demandez à Claude d’exécuter du code non fiable ou généré dans une microVM isolée qui n’a accès qu’au dossier de l’espace de travail.
Créer un point de contrôle et revenir en arrière dans un bac à sable — Enregistrez un point de restauration incluant la mémoire et les processus en cours d’exécution, puis revenez à ce point avec les processus relancés.
Dupliquer un bac à sable en cours d’exécution — Dupliquez un bac à sable actif en copies indépendantes pour tester plusieurs approches en parallèle et conserver celle qui fonctionne.
Restreindre le trafic réseau sortant — Créez un bac à sable dont le réseau ne peut accéder qu’aux hôtes de votre liste d’autorisation, tout le reste étant refusé.
Vérifier l’état du démon — Demandez à Claude de vérifier si le démon kosa8 est en cours d’exécution et d’indiquer sa version.

Documentation

Plugin kosa8 pour Claude Code

kosa8 : une infrastructure sécurisée pour les agents IA.

Offrez à Claude une machine isolée pour travailler. Ce plugin connecte Claude Code à kosa8, une infrastructure sécurisée pour les agents IA : chaque agent dispose de sa propre machine isolée, une véritable microVM avec son propre noyau, et non un conteneur partageant le noyau de l’hôte.

Une fois le plugin activé, Claude peut :

exécuter du code non fiable ou écrit par un agent dans une microVM isolée qui ne voit qu’un dossier (l’espace de travail) et rien d’autre sur l’hôte ;
travailler derrière un réseau fermé, où seuls les hôtes figurant sur une liste d’autorisation que vous définissez sont accessibles, et où toute autre connexion est refusée ;
utiliser des clés API sans les détenir : un courtier de sortie sur l’hôte les injecte lors de l’envoi, et le bac à sable ne contient qu’un espace réservé ;
créer un point de contrôle de toute la machine en cours d’exécution, mémoire et processus compris, en environ 0,7 seconde avant une étape risquée, puis revenir à cet état, toujours en cours d’exécution, en environ une seconde en cas de problème ;
dupliquer une machine en cours d’exécution pour essayer plusieurs approches en parallèle et conserver celle qui fonctionne ;
attendre l’approbation d’une ou deux personnes nommées pour les actions risquées (la règle des deux personnes), chaque action étant consignée dans un journal d’audit chaîné par hachage et infalsifiable.

Le plugin comporte quatre éléments :

Un serveur MCP (.mcp.json) qui lance kosa8 mcp serve via scripts/kosa8-mcp en tant que processus stdio local.
Une compétence (skills/kosa8-sandbox) qui indique à Claude quand utiliser un bac à sable et comment utiliser en toute sécurité les points de contrôle, le retour en arrière, les duplications, les listes d’autorisation de sortie réseau et les approbations.
Commandes : /kosa8:status, /kosa8:sandbox <task>, /kosa8:checkpoint, /kosa8:rewind (demande confirmation avant de revenir en arrière) et /kosa8:explore (essayer plusieurs commandes dans des duplications parallèles).
Agents : sandbox-runner exécute du code non fiable ou généré dans une microVM isolée et indique ce qu’il a fait ; fork-explorer compare des approches dans des duplications parallèles d’un même bac à sable en cours d’exécution.

Prérequis

Claude Code.
kosa8 installé sur la même machine, avec kosa8 sur votre PATH. kosa8 fonctionne sur les Mac équipés d’une puce Apple et sur Linux x86-64, ainsi que sur Windows via WSL2 (version préliminaire). Téléchargez-le depuis kosa8.com/download. Les versions sont signées et notariées. Vérifiez l’installation avec kosa8 version.
Le démon kosa8 en cours d’exécution. Le plugin est un simple lanceur : les bacs à sable sont des microVM exécutées par kosa8d sur votre machine ; rien ne fonctionne donc tant que le démon n’est pas lancé.

Avant de commencer : installer kosa8 et démarrer le démon

Le plugin n’installe pas kosa8 et ne peut pas fonctionner sans lui. Sur une nouvelle machine :

# 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 indique kosa8 daemon: not running, exécutez de nouveau kosa8 daemon start. Le serveur MCP démarre sans le démon, mais tous les outils de bac à sable renvoient alors cannot reach kosa8d.

Les agents qui installent ce serveur pour un utilisateur peuvent suivre llms-install.md.

Installation

Dans Claude Code, ajoutez ce dépôt comme marketplace et installez le plugin :

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

Ou depuis votre shell :

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

Redémarrez Claude Code (ou exécutez /reload-plugins). Exécutez /mcp pour vérifier que le serveur kosa8 est connecté, puis demandez à Claude de « vérifier l’état de kosa8 ».

Partage de dossiers de l’hôte

Par défaut, les agents ne peuvent partager aucun répertoire de l’hôte avec un bac à sable. Pour leur permettre de partager un dossier de projet, démarrez le serveur avec --allow-mount DIR (lecture seule) ou --allow-mount DIR:rw. Vous pouvez le faire en ajoutant votre propre entrée de serveur MCP, par exemple dans le fichier .mcp.json d’un projet :

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

Réseau et clés

L’accès réseau d’un bac à sable est défini lors de sa création. Pour donner à un bac à sable accès à une seule API, et à rien d’autre, créez-le depuis votre terminal :

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

Outils

kosa8 mcp serve expose les outils suivants (selon kosa8 mcp tools dans kosa8 0.5.0) :

Outil	Fonction
`kosa8_status`	Vérifier si le démon kosa8 est en cours d’exécution et indiquer sa version
`sandbox_create`	Démarrer un bac à sable microVM isolé avec son propre noyau et son propre moteur de conteneurs
`sandbox_list`	Lister les bacs à sable, y compris le parent dont provient chaque duplication
`sandbox_run`	Exécuter un conteneur dans le moteur privé d’un bac à sable, isolé de l’hôte
`sandbox_pull`	Télécharger une image dans le moteur privé d’un bac à sable
`sandbox_checkpoint`	Enregistrer un point de restauration, mémoire et processus en cours d’exécution compris
`sandbox_checkpoint_list`	Lister les points de restauration d’un bac à sable
`sandbox_rewind`	Restaurer un bac à sable à un point de contrôle, en reprenant les processus
`sandbox_fork`	Dupliquer un bac à sable en cours d’exécution en N copies indépendantes
`sandbox_explore`	Sélectionner le meilleur résultat parmi N : créer une duplication par commande candidate, les exécuter simultanément et conserver la gagnante
`sandbox_snapshot`	Capturer l’état complet d’un bac à sable sous forme d’instantané
`sandbox_stop`	Arrêter un bac à sable sans le supprimer
`sandbox_start`	Démarrer un bac à sable arrêté à partir de son propre disque
`sandbox_delete`	Arrêter et supprimer un bac à sable et sa VM
`snapshot_list`	Lister les instantanés de bac à sable enregistrés
`snapshot_restore`	Démarrer un bac à sable à partir d’un instantané en reprenant ses processus
`snapshot_rm`	Supprimer un instantané
`container_run`	Exécuter un conteneur jusqu’à son terme et renvoyer sa sortie
`container_exec`	Exécuter une commande dans un conteneur en cours d’exécution
`container_list`	Lister les conteneurs
`container_logs`	Récupérer la sortie d’un conteneur
`container_stats`	Indiquer l’utilisation du processeur, de la mémoire et des PID d’un conteneur
`container_stop`	Arrêter un conteneur en cours d’exécution
`image_build`	Construire une image à partir d’un Dockerfile dans un répertoire de l’hôte
`image_list`	Lister les images
`image_pull`	Télécharger une image depuis un registre
`network_create`	Créer un réseau de pont isolé
`network_list`	Lister les réseaux de conteneurs
`volume_create`	Créer un volume nommé
`volume_list`	Lister les volumes nommés

Exécutez kosa8 mcp tools pour afficher la liste correspondant à la version installée.

Ce qu’exécute ce plugin

Le seul exécutable du plugin est scripts/kosa8-mcp, un court script shell qui repère kosa8 déjà installé sur votre machine et exécute kosa8 mcp serve. Il ne télécharge et n’installe rien. Le plugin lui-même n’envoie aucune donnée, ne contacte aucun serveur et ne lit aucun identifiant.

Autres clients MCP

Le même serveur est publié dans le registre MCP officiel sous le nom io.github.kosa8ai/kosa8 (voir server.json). Il est distribué sous forme de bundle MCP, kosa8-mcp.mcpb, joint à chaque version GitHub : un manifeste et le même court lanceur que scripts/kosa8-mcp. Il ne télécharge et n’installe rien ; installez donc kosa8 au préalable.

Tout client MCP capable de démarrer un serveur stdio peut également exécuter directement kosa8 mcp serve.

Confidentialité

Le serveur MCP kosa8 s’exécute localement et communique avec le démon kosa8 sur la même machine. Conformément à la politique de confidentialité de kosa8, les appels d’outils effectués par votre agent, leurs arguments et leurs résultats restent sur votre machine et ne sont jamais transmis à kosa8. La politique répertorie tout ce que le logiciel kosa8 envoie et à quel moment, y compris les vérifications de licence pour les licences payantes, et explique comment désactiver tous les appels sortants avec KOSA8_OFFLINE=1.

Politique complète : https://kosa8.com/privacy/

Tarifs

kosa8 est un logiciel commercial. Les fichiers du plugin dans ce dépôt sont gratuits et sous licence MIT, mais kosa8 lui-même nécessite une licence : une période d’essai gratuite de 14 jours donnant accès à toutes les fonctionnalités est incluse, sans compte ni carte bancaire. Les forfaits commencent à 29 $ par mois. Voir https://kosa8.com/pricing/.

Assistance et contact

E-mail : contact@kosa8.com
Problèmes : https://github.com/kosa8ai/kosa8-claude-plugin/issues
Site web : https://kosa8.com

Licence

Les fichiers de ce dépôt sont publiés sous la licence MIT. La licence couvre uniquement les fichiers de ce dépôt (le plugin Claude Code : son manifeste, le fichier marketplace, la configuration MCP, la compétence, les commandes, les agents, le lanceur, le README et le logo). Elle ne couvre pas le logiciel kosa8 lui-même, qui est un logiciel commercial distribué séparément selon ses propres conditions.