OpenParable
Skip to content
← Back to skills

Codemod Jssg Sandbox

Development
codemod-jssg-sandbox

Codemod Jssg Sandbox is an Agent Skill for development published in the codemod/codemod repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when working on JSSG, Codemod's JavaScript/TypeScript sandbox, ast-grep bindings, QuickJS runtime, WASM/native sandbox behavior, runtime module shims, sandbox capabilities, packages/jssg-types, packages/jssg-utils, or codemod author APIs.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/codemod/codemod/blob/HEAD/.agents/skills/codemod-jssg-sandbox/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/codemod-jssg-sandbox, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Codemod JSSG Sandbox

Key Areas

  • Rust sandbox: crates/codemod-sandbox/src
  • TypeScript runtime glue: crates/codemod-sandbox/js
  • Sandbox package tests: crates/codemod-sandbox/tests
  • Type declarations: packages/jssg-types/src
  • Author utilities: packages/jssg-utils/src

Rules

  • Do not hand-edit generated artifacts: crates/codemod-sandbox/dist, js/factory.js, or sandbox.wasm.
  • Keep native and WASM behavior aligned for runtime modules, filesystem access, ast-grep bindings, and capabilities.
  • Capability changes often need Rust capability updates, TS exports, and declaration updates.
  • Keep sandbox isolation explicit. Treat filesystem, process, network, and module access as security boundaries.
  • Do not print directly to stdout/stderr from sandbox internals or JSSG packages. Return output, diagnostics, metrics, and logs to callers so crates/cli can route TUI, text, and JSONL modes.
  • JSSG utility functions should produce predictable edits and clear types for codemod authors.

Validation

  • Sandbox Rust: cargo test -p codemod-sandbox
  • Sandbox package: pnpm --filter @codemod.com/codemod-sandbox test
  • Sandbox build: pnpm --filter @codemod.com/codemod-sandbox build
  • JSSG utils: pnpm --filter @jssg/utils test
  • Type declarations: pnpm --filter @codemod.com/jssg-types typecheck