Skip to main content

Getting Started

Agent setup

Copy one prompt to wire wsl-shadow into your coding agent harness.

Prompt

You are helping integrate wsl-shadow into this project.

1. Read https://github.com/kanchingyg/wsl-shadow/blob/HEAD/AGENTS-SNIPPET.md and https://github.com/kanchingyg/wsl-shadow/blob/HEAD/skill/wsl-shadow/SKILL.md.
2. Add the AGENTS snippet to AGENTS.md (or the project's agent instruction file).
3. Wire `PATH="$(wsl-shadow --preflight):$PATH"` (or equivalent) before any agent spawn that runs node/npm/bun inside WSL.
4. Never run `wsl-shadow --apply` unless the human typed apply. Suggest --fix first.
5. Prefer the Linux binary over npx/bunx on Windows hosts.

Source: AGENTS-SNIPPET.md

Drop-in files

Rules

  • Suggest --apply. Do not run it unless the human typed apply.
  • Prefer --fix and --preflight in harness wiring.
  • Prefer the Linux binary over Windows npx / bunx.