capsulerun/bash

Overview

capsulerun/bash is an open-source TypeScript package that provides a sandboxed bash environment for agents. It tracks changes after every command, allowing observers to review the effects of each operation.

Best for

Best for
Developers building agentic systems that need safe, auditable bash execution with minimal overhead

Use cases

• Run arbitrary bash commands in an isolated environment from agent tools
• Monitor file system changes triggered by command execution
• Build agentic workflows that require safe, auditable shell access

How to use

Install

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

Tools exposed

• pnpm

Example client config

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

Notes

capsulerun/bash is an open-source TypeScript package that provides a sandboxed bash environment for agents. It tracks changes after every command, allowing observers to review the effects of each operation.

10 stars on GitHub. Last updated 2026-05-16. Licensed Apache-2.0.

Use cases

• Run arbitrary bash commands in an isolated environment from agent tools
• Monitor file system changes triggered by command execution
• Build agentic workflows that require safe, auditable shell access

Pros

• Provides isolation for bash execution, reducing risk of side effects
• Change tracking on every command enables fine-grained auditing
• Lightweight TypeScript package suitable for integration into MCP servers

Cons

• Low project maturity with only 10 GitHub stars
• Limited community support and documentation
• May lack advanced sandboxing features found in more established tools

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.