Install SDODS

What the installer does

1. 1.Checks Node

   Needs Node 22+. Prints the exact fix for your platform, or installs it with --install-node.

2. 2.Installs Bun

   Only if you do not have it, and only inside ~/.sdods — your system stays untouched.

3. 3.Fetches SDODS

   A shallow clone into ~/.sdods/app, switching to npm automatically once packages are published.

4. 4.Installs browsers

   Chromium by default; --browsers all adds Firefox and WebKit, --browsers none skips them.

5. 5.Writes the command

   An sdods shim in ~/.local/bin. Your shell profile changes only with --modify-path.

6. 6.Verifies

   Runs sdods doctor and prints the commands to try next.

After it finishes

Run the demo suite

cd ~/.sdods/app && sdods run -p demo-shop -e staging -l api

Try the UI layer

sdods run -p demo-shop -e staging -l ui -b chromium -t @smoke

See the results

sdods report --last --open

Open the web UI

sdods serve

Start from your app

sdods analyze /path/to/your-app --apply

Use it from your AI CLI

sdods mcp install claude   # or: codex

Common options

# scaffold a workspace and wire up Claude Code in one go
curl -fsSL https://sdods.com/install.sh | sh -s -- --workspace ~/my-tests --mcp claude

# every browser, and put sdods on PATH permanently
curl -fsSL https://sdods.com/install.sh | sh -s -- --browsers all --modify-path

# pin a release, install somewhere else
curl -fsSL https://sdods.com/install.sh | sh -s -- --version v0.2.0 --dir /opt/sdods

# see what it would do, or remove it
curl -fsSL https://sdods.com/install.sh | sh -s -- --dry-run
curl -fsSL https://sdods.com/install.sh | sh -s -- --uninstall --yes

Every flag has an environment-variable twin for Docker and CI. The full table is in the installer reference.

Requirements

Node.js 22 or newer, and about 2 GB of disk for the checkout, its dependencies and one browser. Git is used for the source install. Everything else the installer handles, and nothing is required to run tests: SDODS needs no account and no API key.