kosa8 plugin for Claude Code

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 startskosa8 mcp servethroughscripts/kosa8-mcpas 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-runnerruns untrusted or generated code in a sealedmicroVM and reports what it did;fork-explorercompares approaches inparallel forks of one running sandbox.
Prerequisites
- Claude Code.
- kosa8 installed on the same machine, with
kosa8on yourPATH. 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 withkosa8 version. - The kosa8 daemon running. The plugin is a thin launcher: the sandboxes aremicroVMs run by
kosa8don 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
- Email: [email protected]
- Issues: https://github.com/kosa8ai/kosa8-claude-plugin/issues
- Website: https://kosa8.com
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.