About this project

just-bash is a monorepo from Vercel Labs that hosts the just-bash package along with example consumers. According to the repository README, the package provides a simulated bash environment with a virtual filesystem, and the project is described as "Bash for Agents." The package is published on npm under the name just-bash and is licensed under Apache-2.0. The repository layout separates publishable npm packages under packages/ from example consumers under examples/, which include a bash-agent example, a cjs-consumer example, and a website. CI workflows live under .github/. Development is managed with pnpm workspaces. Documented commands include pnpm install to install all workspace dependencies, pnpm build to build all packages, pnpm test:run to run unit and comparison tests, pnpm test:dist to smoke-test the bundled output, pnpm lint for biome plus per-package banned-pattern checks, and pnpm typecheck for tsc across all packages. Per-package scripts can be run with pnpm --filter, for example pnpm --filter just-bash test:wasm. The README points readers to the package's own README for usage documentation, so detailed API and usage guidance lives in packages/just-bash. The repository does not state performance claims, benchmarks, or comparisons with other tools in the material provided.