Thanks for contributing to outscraper-cli.

Requirements:

• Node.js 18+
• npm

Install dependencies:

npm ci

Build the CLI:

npm run build

Run the built CLI locally:

node dist/index.js --help

• src/ - TypeScript source code
• dist/ - compiled build output
• templates/ - starter project templates copied by outscraper init
• skills/ - bundled skills used by outscraper setup skills

1. Create a branch for your change.
2. Make changes in src/, templates/, or skills as needed.
3. Run:

npm test
npm run build

4. Verify the relevant CLI command manually.
5. Open a pull request with a clear summary of the change.

• Prefer small, focused pull requests.
• Update README.md when user-facing behavior changes.
• Do not edit generated output manually unless required for verification.
• Prefer changing source files in src/; build output should be generated from source.
• Keep CLI error messages actionable and concrete.

Current test coverage is minimal, so manual verification is important.

At minimum, validate:

• outscraper --help
• the command you changed
• npm publish --dry-run if packaging behavior changed

Use semantic versioning:

• patch for fixes and small UX improvements
• minor for new commands or new CLI capabilities
• major for breaking CLI changes