just-bash README

The project's README from github.com/vercel-labs/just-bash. As one markdown file: README.md.

just-bash monorepo

This repository hosts the just-bash package and its examples.

Packages

Package Path Description
just-bash packages/just-bash A simulated bash environment with virtual filesystem

See the package's own README for usage documentation.

Layout

packages/         publishable npm packages
examples/         example consumers (bash-agent, cjs-consumer, website)
.github/          CI workflows

Working in the repo

pnpm install              # install all workspace deps
pnpm build                # build all packages
pnpm test:run             # run unit + comparison tests
pnpm test:dist            # smoke-test the bundled output
pnpm lint                 # biome + per-package banned-pattern checks
pnpm typecheck            # tsc across all packages

Per-package commands run via pnpm --filter <name> <script> — e.g. pnpm --filter just-bash test:wasm.

just-bash (vercel-labs/just-bash)

Searching Database…

Что это такое?just-bash — симулированная среда bash с виртуальной файловой системой, созданная, чтобы агенты для кодинга выполняли шелл-подобные команды в безопасной песочнице, не трогая реальную файловую систему. Репозиторий описывает проект как 'Bash for Agents'.
Это CLI-инструмент или библиотека для импорта?Это библиотека: репозиторий — монорепо, где живёт пакет 'just-bash' и его примеры кода, а не отдельный CLI, устанавливаемый глобально.
Как добавить just-bash в свой проект?Вы берёте пакет just-bash из packages/just-bash в этом монорепо; корневой README описывает только структуру репозитория, поэтому реальные шаги установки/использования лежат в собственном README пакета.
Нужен ли дополнительный инструментарий для сборки или тестов?Монорепо управляется через pnpm workspaces, поэтому вы запускаете команды для отдельных пакетов вроде 'pnpm --filter just-bash test:wasm'; сам пакет не декларирует внешних рантайм-зависимостей.
Полная документация здесь или в другом месте?Этот README верхнего уровня — просто карта монорепо; подробное поведение, API и нюансы виртуальной bash-среды описаны в собственном README пакета just-bash, которое в этот файл не входит.
Он работает только в Node или ещё и в браузере?Есть отдельный шаг сборки 'build:worker' и набор тестов 'test:wasm' наряду с обычной TypeScript-сборкой, что указывает на WebAssembly-цель, предназначенную для работы вне чистой Node (например, в браузере или песочнице воркера) в дополнение к обычному пакету.
just-bash — настоящий интерпретатор bash или лишь приближение?Он описывается как 'simulated bash environment', то есть эмулирует bash-подобные команды поверх виртуальной файловой системы, а не является полноценной POSIX-совместимой оболочкой.
Зачем агенту фальшивый bash вместо настоящего шелла?Выполнение команд над виртуальной файловой системой позволяет ИИ-агенту безопасно выполнять bash-подобные операции, не рискуя повредить реальные файлы хост-машины.
just-bash тянет много внешних зависимостей?В метаданных пакета не указано ни одной внешней рантайм-зависимости — библиотека самодостаточна.
Size
30 MB
Stars
4.4K
Age
9mo
Commits · 90 Days