Skip to main content
Glama

scratch4js

A pnpm monorepo of small, focused JavaScript packages for working with Scratch and TurboWarp β€” edit .sb3 projects programmatically, talk to the Scratch website, drive it all from an AI agent, and build & bundle TurboWarp extensions.

πŸ“– Documentation: https://playforge-coding.github.io/scratch4js/

Packages

Path

Package

What it is

packages/scratch4js

scratch4js

The core library: read/edit .sb3 files with a small, declarative API.

packages/s-api4js

s-api4js

A class-based wrapper for the Scratch website API: read public data, and log in to download/edit/publish .sb3.

packages/scratch-mcp

scratch-mcp

An MCP server exposing the library's editing surface as tools, plus a TurboWarp live-reload bridge.

packages/tw-plugin-webpack

tw-plugin-webpack

webpack/Rspack plugin that bundles a multi-file TurboWarp extension into one IIFE-wrapped file.

packages/tw-plugin-rollup

tw-plugin-rollup

Rollup/Rolldown/Vite plugin that bundles a multi-file TurboWarp extension into one IIFE-wrapped file.

packages/create-tw-extension

create-tw-extension

Scaffolder (npm create tw-extension) for a new TurboWarp extension project with your choice of bundler.

packages/web-editor

browser-ide-kit

Reusable React building blocks for in-browser IDEs: split-pane layout, Monaco, an xterm/WebContainer terminal, file tree.

packages/tw-extension-maker

tw-extension-maker

In-browser IDE (built on browser-ide-kit) that bundles a TurboWarp extension in a WebContainer and previews it live.

packages/userscript

userscript

TurboWarp Desktop userscript (ES modules β†’ one IIFE): scratch-mcp live-reload + real-time collaboration over a WebSocket relay.

Related MCP server: scratch-mcp

How they fit together

  AI agent / MCP client
          β”‚  (MCP tools over stdio)
          β–Ό
   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”   edits in memory   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
   β”‚  scratch-mcp β”‚ ──────────────────► β”‚ scratch4js β”‚
   β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜   save β†’ .sb3 file  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
          β”‚ WebSocket bridge (localhost:9060)
          β–Ό  "loadSB3" β†’ fetch /get.sb3
   TurboWarp Desktop + userscript  ──►  live preview

An agent edits a project through scratch-mcp; on save the server writes the .sb3 and signals the userscript, which reloads it into TurboWarp Desktop instantly.

Getting started

pnpm install
pnpm build          # build every package (-r build)
pnpm lint
pnpm fmt            # prettier --write .

Then:

  1. Install the userscript into TurboWarp Desktop (pnpm --filter userscript deploy; per-OS paths in its README).

  2. Run the MCP server and point your MCP client at it.

  3. Open .sb3 files, edit, and save_project to see changes live.

Workspace layout

.
β”œβ”€β”€ packages/
β”‚   β”œβ”€β”€ scratch4js/          # the core library (+ examples + example.sb3)
β”‚   β”œβ”€β”€ s-api4js/            # Scratch website API wrapper
β”‚   β”œβ”€β”€ scratch-mcp/         # the MCP server + live-reload bridge
β”‚   β”œβ”€β”€ tw-plugin-webpack/   # webpack/Rspack extension bundler plugin
β”‚   β”œβ”€β”€ tw-plugin-rollup/    # Rollup/Rolldown/Vite extension bundler plugin
β”‚   β”œβ”€β”€ create-tw-extension/ # extension scaffolder CLI
β”‚   β”œβ”€β”€ web-editor/          # in-browser IDE building blocks
β”‚   β”œβ”€β”€ tw-extension-maker/  # in-browser extension IDE
β”‚   └── userscript/          # TurboWarp Desktop userscript: live-reload + collaboration
β”œβ”€β”€ docs/                    # Rspress documentation site
β”œβ”€β”€ pnpm-workspace.yaml
└── package.json             # workspace root (build/lint/fmt delegate to -r)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Enables editing Scratch .sb3 projects programmatically, including sprites, blocks, costumes, sounds, variables, and online project sharing, plus headless VM execution and live-reload in TurboWarp Desktop.
      43
      30 npm
      Mozilla Public 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to drive a running Roblox Studio in real time over a single WebSocket, executing whole Luau programs, installing in-engine controllers, hot-patching scripts during live playtests, and receiving errors, assertions and other events as pushes. It also reaches Roblox Open Cloud for the open place and answers visual questions via a vision sidecar, exposing all of this through nine MCP tools.
      9
      1
      MIT