vercel-labs/just-bash

Health v2 · maintenance only

Flags: no_license

Adoption not part of the score

4212 stars · 242 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

just-bash is a TypeScript-implemented bash interpreter with an in-memory virtual filesystem, designed to give AI agents a secure, sandboxed shell environment. It supports common unix commands and bash syntax, with optional curl, Python, JS/TS, and sqlite support, and allows defining custom commands in TypeScript.

Use cases

• run bash commands safely inside an AI agent
• sandbox shell execution without a real OS shell
• simulate a filesystem for LLM tool use
• execute unix commands in a browser or Node environment
• give coding agents a terminal tool
• test bash scripts in isolation

When to choose

• you need a secure sandboxed bash environment for AI agents without container overhead
• you want to run shell commands in pure TypeScript/JavaScript
• you need a virtual filesystem shared across shell invocations
• you want to extend the shell with custom TypeScript commands

When to avoid

• you need full, byte-perfect bash compatibility with real system behavior
• you need to execute real binaries or access the actual host filesystem
• you need production-grade guarantees — it is beta software

Facets

library · maturity active

interpreter simulation security agent-framework file-system cli developer-tools artificial-intelligence cross-platform wasm sandboxed-shell virtual-filesystem bash-emulation ai-agent-tools in-memory-fs ai-agents command-line nodejs typescript

Member repositories

For agents

markdown · JSON · MCP: product_card(name="vercel-labs/just-bash")