Awesome just-bash

A curated list of resources for just-bash — a virtual bash environment with an in-memory filesystem, designed for AI agents.

just-bash gives an agent a real-feeling shell — pipes, redirections, loops, jq, sqlite3, optional Python and JS — without giving it your machine. This list tracks ports, filesystem adapters, integrations, and projects building on it.

Contents

• Official
• Ports
• Filesystem Adapters
• Libraries
• Integrations
• Built With just-bash
• Contributing

Official

• just-bash — The original TypeScript implementation from Vercel Labs.
• bash-tool — A thin AI SDK tool wrapper around just-bash, ready to drop into a generateText / streamText call.
• justbash.dev — Project homepage and docs.

Ports

Reimplementations of just-bash in other languages.

• just-bash-py — Pure-Python port by Drew Breunig. Same in-memory virtual filesystem model, callable from Python agents.
• just-bash (Rust) — Rust port.
• just-bash-rs — Second Rust port with three filesystem modes (Memory, ReadThrough, Passthrough), 25 built-in commands, and a declarative command extension system.
• just-bash-swift — Pure-Swift port targeting iOS, macOS, and iPadOS where Process/NSTask are unavailable. In-memory VFS, 40+ commands, recursive-descent parser, ships as a SwiftPM library.
• just_bash — Elixir port with in-memory VFS, HTTPS-only network access with host allowlists, custom command behaviour via JustBash.Commands.Command, and a ~b sigil for one-liner scripting.

Filesystem Adapters

just-bash ships with InMemoryFs, OverlayFs, ReadWriteFs, and MountableFs. These pluggable adapters add new backends.

• just-bash-dropbox — Dropbox-backed filesystem. Reads and writes go to a Dropbox account.
• just-bash-gdrive — Google Drive filesystem adapter.
• just-bash-openfs — OpenFS adapter.
• bash-gres — PostgreSQL-backed IFileSystem with workspace isolation via row-level security, BM25 full-text search, and optional pgvector semantic/hybrid search. Works with postgres.js or Drizzle.
• just-bash-postgres — Second Postgres filesystem provider using ltree hierarchy, full-text search, pgvector semantic/hybrid search, and per-session row-level security.
• durable-bash — Cloudflare Durable Object-backed IFileSystem adapter. Persists bash command output in a Durable Object's SQLite storage; 121 tests, full IFileSystem interface coverage, ships as @stablemodels/durable-bash.

Libraries

Helper packages for building on top of just-bash.

• just-bash-util — Type-safe CLI command framework for defineCommand. Subcommands with option inheritance, auto-generated --help, typo suggestions, and a command() builder reminiscent of commander/yargs.
• just-git — Pure-TypeScript git implementation with 36 commands that plugs into just-bash as a custom command — pipes, redirects, and && chaining work natively. Also ships a standalone embeddable git server with HTTP/SSH/in-process transport and pluggable storage (SQLite, Postgres, Durable Objects).

Integrations

• agentfs — Turso's filesystem-for-agents. Ships an ai-sdk-just-bash example showing the two together.
• just-bash-mcp — MCP server exposing a sandboxed just-bash environment to any MCP client.
• convex-sandbox — Persistent bash sandboxes backed by Convex file storage. Lazy filesystem hydration, mutation-diffing writeback, and session-persisted cwd — no VMs or containers.

Built With just-bash

Notable projects that depend on just-bash in the wild.

• vercel-labs/agent-browser — Vercel's agent browser uses just-bash in its docs runtime.
• coplane/localsandbox — Local sandbox shim that wires just-bash and agentfs together.

Contributing

Contributions welcome. Open a PR adding your project, or an issue with a link and I'll take a look. Please keep entries to one line and lead with what makes the project distinct, not what it generically does.

License

To the extent possible under law, the contributors have waived all copyright and related or neighboring rights to this work.