just-bash

Why we included this project

Agents that need to run shell commands usually face a hard safety problem: how do you let the model touch a real shell without letting it wreck the machine? just-bash sidesteps that by simulating a bash environment in memory. It's a TypeScript package with a virtual filesystem, so an agent can create files, pipe output through grep or jq, query sqlite, and run Python or JavaScript code, all inside a sandbox that never touches the host. Each exec() call resets the shell state while the filesystem persists, which keeps sessions coherent. It installs from npm and accepts custom TypeScript commands. The project is beta and its security model is documented, so check the isolation boundaries before production use, but for prototyping agent tool use it's a solid choice.