kosa8ai

kosa8 plugin for Claude Code

Community kosa8ai
Updated

kosa8: Secure infrastructure for AI agents. Claude Code plugin and MCP server: sealed microVM sandboxes you can checkpoint, rewind and fork.

kosa8 plugin for Claude Code

kosa8

kosa8: Secure infrastructure for AI agents.

Give Claude a sealed machine to work in. This plugin connects Claude Code tokosa8, secure infrastructure for AI agents: every agentgets its own sealed machine, a real microVM with its own kernel, not acontainer sharing the host's kernel.

With the plugin enabled, Claude can:

  • run untrusted or agent-written code in a sealed microVM that sees one folder(the workspace) and nothing else on the host;
  • work behind a closed network, where only hosts on an allow-list you write arereachable and anything else gets a refused connection;
  • use API keys without holding them: an egress broker on the host injects themon the way out, and the sandbox holds only a placeholder;
  • checkpoint the whole running machine, memory and processes, in about 0.7seconds before a risky step, and rewind it, still running, in about a secondwhen something goes wrong;
  • fork a running machine into live copies to try approaches in parallel andkeep the one that works;
  • wait for one or two named human approvers on risky actions (the two-personrule), with every action written to a hash-chained, tamper-evident audit log.

The plugin has four parts:

  • An MCP server (.mcp.json) that starts kosa8 mcp serve throughscripts/kosa8-mcp as a local stdio process.
  • A skill (skills/kosa8-sandbox) that tells Claude when to reach for asandbox and how to use checkpoints, rewind, fork, egress allow-lists andapprovals safely.
  • Commands: /kosa8:status, /kosa8:sandbox <task>, /kosa8:checkpoint,/kosa8:rewind (asks before rewinding) and /kosa8:explore (try severalcommands in parallel forks).
  • Agents: sandbox-runner runs untrusted or generated code in a sealedmicroVM and reports what it did; fork-explorer compares approaches inparallel forks of one running sandbox.

Prerequisites

  • Claude Code.
  • kosa8 installed on the same machine, with kosa8 on your PATH. kosa8 runson Apple-chip Macs and x86-64 Linux, and on Windows through WSL2 (preview).Install it from kosa8.com/download.Releases are signed and notarised. Check the install with kosa8 version.
  • The kosa8 daemon running. The plugin is a thin launcher: the sandboxes aremicroVMs run by kosa8d on your machine, so nothing works until it is up.

Before you start: install kosa8 and start the daemon

The plugin does not install kosa8 and cannot run without it. On a newmachine:

# 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

If kosa8 version reports kosa8 daemon: not running, runkosa8 daemon start again. The MCP server starts without the daemon, butevery sandbox tool then answers cannot reach kosa8d.

Agents installing this server for a user can followllms-install.md.

Install

In Claude Code, add this repository as a marketplace and install the plugin:

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

Or from your shell:

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

Restart Claude Code (or run /reload-plugins). Run /mcp to confirm thekosa8 server is connected, and ask Claude to "check kosa8 status".

Sharing host folders

By default, agents cannot share any host directory into a sandbox. To let themshare a project folder, start the server with --allow-mount DIR (read-only)or --allow-mount DIR:rw. You can do that by adding your own MCP server entry,for example in a project's .mcp.json:

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

Network and keys

Network access for a sandbox is set when it is created. To give a sandboxaccess to one API and nothing else, create it from your terminal:

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

Tools

kosa8 mcp serve exposes these tools (as reported by kosa8 mcp tools inkosa8 0.5.0):

Tool What it does
kosa8_status Check whether the kosa8 daemon is running and report its version
sandbox_create Boot an isolated microVM sandbox with its own kernel and container engine
sandbox_list List sandboxes, including which parent each fork came from
sandbox_run Run a container inside a sandbox's private engine, isolated from the host
sandbox_pull Pull an image into a sandbox's private engine
sandbox_checkpoint Save a restore point, including memory and running processes
sandbox_checkpoint_list List a sandbox's restore points
sandbox_rewind Put a sandbox back to a checkpoint, with processes resumed
sandbox_fork Fork a running sandbox into N independent copies
sandbox_explore Best-of-N: fork once per candidate command, run them concurrently, keep the winner
sandbox_snapshot Capture a sandbox's full state as a snapshot
sandbox_stop Stop a sandbox without deleting it
sandbox_start Start a stopped sandbox from its own disk
sandbox_delete Stop and delete a sandbox and its VM
snapshot_list List saved sandbox snapshots
snapshot_restore Boot a sandbox from a snapshot, resuming its processes
snapshot_rm Delete a snapshot
container_run Run a container to completion and return its output
container_exec Run a command inside a running container
container_list List containers
container_logs Fetch a container's output
container_stats Report CPU, memory and pid usage for a container
container_stop Stop a running container
image_build Build an image from a Dockerfile in a host directory
image_list List images
image_pull Pull an image from a registry
network_create Create an isolated bridge network
network_list List container networks
volume_create Create a named volume
volume_list List named volumes

Run kosa8 mcp tools to see the list for your installed version.

What this plugin runs

The plugin's only executable is scripts/kosa8-mcp, a short shell script thatfinds the kosa8 already installed on your machine and runs kosa8 mcp serve.It downloads and installs nothing. The plugin itself sends no data anywhere,contacts no server and reads no credentials.

Other MCP clients

The same server is published to theofficial MCP Registry asio.github.kosa8ai/kosa8 (see server.json). It is distributed as an MCPbundle, kosa8-mcp.mcpb, attached to eachGitHub release: amanifest and the same short launcher as scripts/kosa8-mcp. It does not downloador install anything, so install kosa8 first.

Any MCP client that can start a stdio server can also run kosa8 mcp servedirectly.

kosa8 Cloud (remote, nothing to install)

To run sandboxes on kosa8 Cloud instead of your own machine, point any MCPclient that speaks Streamable HTTP at the hosted server, with a kosa8 Cloud APIkey (make one at https://app.kosa8.com/app#keys):

{
  "mcpServers": {
    "kosa8-cloud": {
      "type": "streamableHttp",
      "url": "https://api.kosa8.com/mcp",
      "headers": { "Authorization": "Bearer k8c_live_..." }
    }
  }
}

The server's public description, with every tool, is athttps://api.kosa8.com/.well-known/mcp/server-card.json.

Privacy

The kosa8 MCP server runs locally and talks to the kosa8 daemon on the samemachine. Under the kosa8 privacy policy, the toolcalls your agent makes, their arguments and their results stay on your machineand never reach kosa8. The policy lists everything the kosa8 software sends andwhen, including licence checks for paid licences, and how to turn all outboundcalls off with KOSA8_OFFLINE=1.

Full policy: https://kosa8.com/privacy/

Pricing

kosa8 is commercial software with no free tier. The plugin files in thisrepository are free and MIT licensed, but using kosa8 needs an account on aplan: sign up, add a card and pick a plan. Plans start at $29 a month. Seehttps://kosa8.com/pricing/.

Support and contact

License

The files in this repository are released under the MIT License.The license covers only the files in this repository (the Claude Code plugin:its manifest, marketplace file, MCP configuration, skill, commands, agents,launcher, README and logo). It does not cover the kosa8 software itself, whichis commercial software distributed separately under its own terms.

MCP Server · Populars

MCP Server · New

    frontman-ai

    frontman

    The AI agent that lives in your framework/browser

    Community frontman-ai
    Laksh-star

    Screenward

    Movie and TV discovery, watch planning, and streaming availability—for browsers and MCP clients.

    Community Laksh-star
    codescene-oss

    CodeHealth MCP Server

    The CodeScene MCP Server exposes CodeScene’s Code Health analysis as local AI-friendly tools.

    Community codescene-oss
    Poptin-LTD

    poptin-mcp

    Official Poptin MCP server. Connect your AI agent to create email campaigns, analyze popup and form performance, and build targeted audience segments.

    Community Poptin-LTD
    Fan-Pier-Labs

    OpenRecord

    Let Claude read and manage your Epic MyChart health records — labs, meds, messages, refills, imaging. Claude Desktop extension (MCP server), iOS app, and CLI. Runs on your device.

    Community Fan-Pier-Labs