MCPcopy
hub / github.com/vercel-labs/just-bash

github.com/vercel-labs/just-bash @3.0.2 sqlite

repository ↗ · DeepWiki ↗ · release 3.0.2 ↗
3,341 symbols 12,377 edges 954 files 802 documented · 24%
README

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.

Extension points exported contracts — how you extend this code

IFileSystem (Interface)
(no doc) [7 implementers]
packages/just-bash/src/fs/interface.ts
RunResult (Interface)
(no doc)
packages/just-bash-executor/src/node-esm-smoke.test.ts
CountryRecord (Interface)
(no doc)
examples/executor-tools/multi-api-agent.ts
ShellOptions (Interface)
(no doc)
examples/bash-agent/shell.ts
ParseResult (Interface)
(no doc)
examples/website/app/components/lite-terminal/ansi-parser.ts
TransformPlugin (Interface)
(no doc) [4 implementers]
packages/just-bash/src/transform/types.ts
ExecutorHandle (Interface)
(no doc)
packages/just-bash-executor/src/create-executor.ts
WeatherCurrent (Interface)
(no doc)
examples/executor-tools/multi-api-agent.ts

Core symbols most depended-on inside this repo

exec
called by 8069
packages/just-bash/src/regex/user-regex.ts
readFile
called by 514
packages/just-bash/src/fs/interface.ts
setupFiles
called by 511
packages/just-bash/src/comparison-tests/fixture-runner.ts
compareOutputs
called by 467
packages/just-bash/src/comparison-tests/fixture-runner.ts
get
called by 462
packages/just-bash/src/security/defense-in-depth-box.ts
set
called by 401
packages/just-bash/src/security/defense-in-depth-box.ts
replace
called by 377
packages/just-bash/src/regex/user-regex.ts
split
called by 330
packages/just-bash/src/regex/user-regex.ts

Shape

Function 1,843
Method 866
Interface 484
Class 145
Enum 3

Languages

TypeScript100%
Python1%

Modules by API surface

packages/just-bash/src/ast/types.ts105 symbols
packages/just-bash/src/security/defense-in-depth-box.ts66 symbols
packages/just-bash/src/fs/overlay-fs/overlay-fs.ts49 symbols
packages/just-bash/src/regex/user-regex.ts46 symbols
packages/just-bash/src/interpreter/errors.ts46 symbols
packages/just-bash/src/parser/parser.ts44 symbols
packages/just-bash/src/commands/python3/worker.ts44 symbols
packages/just-bash/src/security/worker-defense-in-depth.ts43 symbols
packages/just-bash/src/commands/awk/parser2.ts43 symbols
packages/just-bash/src/commands/query-engine/parser.ts42 symbols
packages/just-bash/src/commands/awk/ast.ts42 symbols
packages/just-bash/src/commands/worker-bridge/protocol.ts40 symbols

Used by 2 indexed graphs manifest dependencies, hub-wide

github.com/nocobase/nocobase
github.com/vercel/ai

Dependencies from manifests, versioned

@ai-sdk/gateway3.0.2 · 1×
@biomejs/biome2.3.10 · 1×
@changesets/changelog-github0.6.0 · 1×
@changesets/cli2.31.0 · 1×
@executor-js/plugin-graphql0.2.0 · 1×
@executor-js/plugin-mcp0.2.0 · 1×
@executor-js/plugin-openapi0.2.0 · 1×
@executor-js/sdk0.2.0 · 1×
@just-bash/executorworkspace:* · 1×
@steipete/summarize-core0.7.1 · 1×
@tailwindcss/postcss4 · 1×
@types/ini4.1.1 · 1×

Datastores touched

appDatabase · 1 repos
myappDatabase · 1 repos
dbDatabase · 1 repos
dbnameDatabase · 1 repos
mydbDatabase · 1 repos

For agents

$ claude mcp add just-bash \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact