Beejs

Beejs is a JavaScript and TypeScript runtime built with Rust and V8. The active product path is the bee CLI over MinimalRuntime, with growing Node.js and Web API compatibility. Performance and compatibility numbers are only valid when backed by current, reproducible benchmarks and conformance scores.

Official Website & Documentation: https://bee.zhanghe.dev

• Rust + V8 execution: Default runtime path is src/runtime_minimal.rs with Tokio-backed timers and I/O work in progress.
• TypeScript support: .ts files are transpiled before execution (self-hosted compiler today; cache and TSX coverage are active work items).
• Fail-closed permissions: Granular broker flags such as --deny-fs / --deny-net.
• Node.js & Web API surface (incremental): Partial fs / http / crypto / fetch / Streams / WebCrypto. See Current Scope and tests/conformance/ for what is actually verified.

Package version is 0.1.0. Treat Current Scope as the only user-facing capability boundary. Historical docs/STAGE_* reports and old “357/357” / “1000-5000x” claims are not current facts.

Compatibility progress is tracked by the Node conformance scorecard under tests/conformance/. Performance claims require the scripts in benchmarks/ against the binary you just built.

Install the latest release with the official one-line script:

curl -fsSL https://bee.zhanghe.dev/install.sh | sh

Or specify a custom version tag or installation directory:

curl -fsSL https://bee.zhanghe.dev/install.sh | BEEJS_VERSION=v0.1.0-repair-sprint sh
curl -fsSL https://bee.zhanghe.dev/install.sh | BEEJS_INSTALL_DIR="$HOME/.local/bin" sh

You can also build the optimized release binary directly using Cargo:

git clone https://github.com/zh30/beejs.git
cd beejs
cargo build --release
./target/release/bee --version

Evaluate JavaScript inline:

bee eval "1 + 1"

Run a JavaScript or TypeScript file natively:

bee run examples/basics/hello_world.js
bee run examples/basics/typescript_demo.ts

Start the interactive REPL:

bee repl

Run test suite smoke checks:

bee test examples/testing/math.test.js

Stable commands:

bee --version
bee --help
bee run <file> [args...]
bee eval <code>
bee repl
bee version

Preview and experimental commands:

bee test [file]
bee bundle <entry> --outfile dist/bundle.js
bee debug <file>
bee serve --host localhost --port 3000
bee init [name]
bee create my-app js
bee create my-ts-app ts
bee add <package>
bee remove <package>
bee install
bee prune
bee bunx <package> [args...]
bee upgrade [package]

See CLI usage guide for full options and examples.

Beejs handles .ts, .tsx, and .wasm modules natively:

bee run examples/basics/typescript_demo.ts

For WebAssembly, Beejs exposes full WebAssembly.compile, WebAssembly.Instance, and shared WebAssembly.Memory buffer APIs through V8 JIT compilation.

Beejs maintains strict quality gates across Rust integration suites:

cargo build --release
cargo test --lib
cargo test --test wasm_v8_execution_tests
cargo test --test http_streaming_response_tests
cargo clippy --all-targets -- -D warnings

• Official Website: https://bee.zhanghe.dev
• Current Scope
• Documentation Index
• CLI Usage Guide
• Project Skill Guide
• Examples
• License

Beejs is released under the MIT License.