README.md

February 16, 2026 ยท View on GitHub

Scramjet

npm version

Scramjet is an experimental interception-based web proxy designed to evade internet censorship and bypass arbitrary browser restrictions.

Scramjet allows you to sandbox arbitrary web content, bypass CORS restrictions on loading websites, and instrument and debug websites inside the browser itself. This is accomplished through a combination of interception, rewriting, and sandboxing techniques. You can learn more about the technical details here.

Supported Sites

Some of the popular websites that Scramjet supports include:

Development

Dependencies

Building

  • Clone the repository with git clone --recursive https://github.com/MercuryWorkshop/scramjet
  • Install the dependencies with pnpm i
  • Build the rewriter with pnpm rewriter:build
  • Build Scramjet with pnpm build

Running Scramjet Locally

You can run the Scramjet dev server with the command

pnpm dev

The demo page for scramjet should now be running at http://localhost:4141 and should rebuild upon a file being changed (excluding the rewriter).