SDODS

Scaffold a new SDODS workspace with an organization, a workspace and the demo project.

sdods init [dir] [--db sqlite|postgres] [--pm bun|pnpm] [--no-demo] [--claude] [--from <app>]
             [--git] [--link] [--no-install] [--no-browsers]
             [--org <slug>] [--org-name <name>] [--workspace <slug>] [--workspace-name <name>] [--force]

Flag	Meaning
`dir`	target directory (default: current directory; must be empty unless `--force`)
`--db`	database driver written to `.env.example` (`sqlite` needs no setup)
`--pm`	package manager used for the install step and printed in next steps
`--no-demo`	skip copying `projects/demo-shop`
`--claude`	run `sdods agent install-claude` afterwards (`.claude/agents`, `.mcp.json`)
`--from <app>`	analyze an application repository and create a project from it (`sdods analyze --apply`)
`--git`	`git init` plus an initial commit
`--link`	depend on the local SDODS packages instead of the npm registry (developing SDODS itself)
`--no-install` / `--no-browsers`	skip the dependency install / the chromium download
`--org`, `--org-name`	organization written to `sdods.workspace.yaml` (default `default`)
`--workspace`, `--workspace-name`	first workspace (default `default`)

What gets created:

File	Purpose
`package.json`	depends on `@sdods/cli`, `@sdods/core` and the runner packages; scripts `test`, `test:api`, `test:ui`, `lint`, `serve`, `doctor`
`sdods.workspace.yaml`	organization, workspaces, `defaultWorkspace`, default processes (`pr-check`, `nightly-regression`, `release-gate`)
`sdods.runner.config.ts`	generated from the project registry (project × layer × browser)
`tsconfig.json`	strict NodeNext config covering `projects/**`
`.env.example`, `.gitignore`	secrets template and ignores (`.sdods/`, `.auth/`, `.env.*`)
`docker-compose.yml`	Postgres 16 and the optional server
`projects/demo-shop/`	the reference project (unless `--no-demo`)
`.claude/skills/`	`sdods-record` and `sdods-run` skills

npx -y @sdods/cli init my-tests --org acme --workspace web && cd my-tests
bun run sdods doctor
bun run sdods workspace tree
bun run sdods run -p demo-shop -e staging -l api

Exit code 2 when the directory is not empty (use --force) or a flag value is invalid.