Contributing to WooTTY

March 1, 2026 ยท View on GitHub

Development prerequisites

  • Node.js >= 24
  • pnpm >= 10
  • Go >= 1.26

Setup

pnpm install
pnpm dev

Validation before opening a PR

pnpm lint
pnpm test
pnpm build
pnpm test:e2e

pnpm lint is the canonical unified command. It formats and lints with Biome, then runs typechecks.

Commit conventions

Use Conventional Commits for every change (required for Release Please):

  • feat: new behavior
  • fix: bug fixes
  • docs: documentation-only
  • chore: maintenance
  • test: tests-only changes

Format:

<type>(optional-scope): <summary>

Examples:

  • fix: resolve Playwright webServer cwd in CI
  • refactor(session): split transport lifecycle boundaries

Scope guidance

  • Keep terminal reliability changes accompanied by tests.
  • Prefer small, reviewable PRs.
  • Update docs when behavior or UX changes.