v0.2.0

Improvements

• Stabilize TypeScript package for production purposes
• Stabilize MCP package for production purposes
• Improve command path resolution
• Improve command logic

v0.1.4

Improvements

• Fix path resolution issues with python3 and node
• Add a default manual.md to the sandbox listing all available commands

v0.1.3

Improvements

• Improve python3 and node for better handling of one‑liner scripts passed with -c and -e options.
• Improve diff system to detect changes more precisely.
• Add sort and uniq commands for better text processing.
• Add -o (only‑matching) option to the grep command.

v0.1.2

Improvements

• Delegate filesystem snapshots to runtime layer (sandbox)
• Upgrade Capsule runtime version to 0.8.10

v0.1.1

Improvements

• Added verification of the sandbox state before executing commands.
• The bash type now returns a boolean, giving immediate feedback on whether the sandbox is ready.
• Commands that fail no longer throw an error;

v0.1.0

Capsule Bash - Sandboxed bash made for agents

TypeScript SDK

npm install @capsule-run/bash @capsule-run/bash-wasm

Run it:

import { Bash } from "@capsule-run/bash";
import { WasmRuntime } from "@capsule-run/bash-wasm";

const bash = new Bash({ runtime: new WasmRuntime() });

const result = await bash.run("mkdir src && touch src/index.ts");

console.log(result);
/*
{
  stdout: "Folder created ✔\nFile created ✔",
  stderr: "",
  diff: { created: ['src', 'src/index.ts'], modified: [], deleted: [] },
  duration: 10,
  exitCode: 0,
}
*/

MCP server

{
  "mcpServers": {
    "capsule": {
      "command": "npx",
      "args": ["-y", "@capsule-run/bash-mcp"]
    }
  }
}

See the MCP Readme for configuration details.

Interactive shell

Clone the repository, then run from the project root:

pnpm -s bash-wasm-shell

Important

Python and pip are required to compile the Python sandbox. Both sandboxes (JS and Python) are needed to run the shell.