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.
• just-bash-mcp — Second MCP server wrapping just-bash with Laminar observability tracing, configurable timeouts, and VS Code MCP integration support.

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.

Template

This repo is also a template for automating other awesome lists.

• Quick start — click "Use this template" on GitHub, open with any agent.
• Tutorial — agent reads CLAUDE.md → runs the .docs/START_HERE.md wizard.
• How-to — pause: touch .discover.disabled. Tune: edit scripts/checks.md.
• Reference — all subject values live in awesome.config.yml (one file).
• Explanation — 8-stage progressive filter: discovery → enrich → LLM gate → PR checklist.

License

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