oorty doctor

Validate your test setup and diagnose issues.

Usage

Terminal

npx oorty doctor [options]

Options

Option	Default	Description
`--fix`	false	Attempt to fix issues automatically
`--cwd <path>`	.	Set the working directory

What It Checks

The doctor command validates the following:

Configuration file - oorty.json exists and is valid
Test directories - unit, component, e2e directories exist
.oorty directory - .oorty/cache, .oorty/plans, .oorty/analysis, .oorty/logs exist
Vitest config - vitest.config.ts exists
Playwright config - playwright.config.ts exists
GitHub workflow - test.yml workflow exists (if CI enabled)
Dependencies - vitest and @playwright/test are installed
Test files - At least one test file exists

Example Output

A healthy setup will show all checks passing:

Terminal

$ npx oorty doctor
Oorty Doctor
Checking your test setup...
  ✓ Configuration file: oorty.json found
  ✓ Configuration valid: oorty.json is valid
  ✓ unit directory: tests/unit/ exists
  ✓ component directory: tests/component/ exists
  ✓ e2e directory: tests/e2e/ exists
  ✓ .oorty directory: .oorty/ exists
  ✓ .oorty/cache directory: .oorty/cache/ exists
  ✓ .oorty/plans directory: .oorty/plans/ exists
  ✓ .oorty/analysis directory: .oorty/analysis/ exists
  ✓ .oorty/logs directory: .oorty/logs/ exists
  ✓ Vitest config: vitest.config.ts found
  ✓ Playwright config: playwright.config.ts found
  ✓ GitHub Actions workflow: test.yml workflow found
  ✓ vitest installed: vitest is installed
  ✓ @playwright/test installed: @playwright/test is installed
  ✓ Test files: Test files found
All 16 checks passed. Your setup looks great!

Fixing Issues

If some checks fail, you can try automatic fixes:

Terminal

npx oorty doctor --fix

The --fix flag will attempt to resolve issues like missing directories. For other issues, follow the guidance in the error messages.

Next: oorty add

Learn how to add new test files.

add command