Contributing

How to contribute to OpenWaggle — current contribution model, issue reporting, and future plans.

OpenWaggle is in early development and we welcome community input.

Current Contribution Model

For now, we accept contributions as prompt suggestions — descriptions of issues, features, or improvements that we implement internally. We’re not yet accepting pull requests with code changes, but plan to open that up in the future.

How to Contribute

Report Bugs

1. Open an issue on GitHub Issues.
2. Include clear steps to reproduce the bug.
3. Mention the OS, Node.js version, and which AI provider/model you were using.
4. Attach screenshots or logs if relevant.

Suggest Features

1. Open an issue with the enhancement label.
2. Describe the use case — what problem does this solve?
3. If possible, include mockups or examples from other tools.

Improve Documentation

Found a typo, unclear instruction, or missing content? Open an issue describing what needs fixing. Documentation suggestions are always welcome.

What We’re Looking For

• Bug reports with reproduction steps
• Feature requests with concrete use cases
• UI/UX feedback and suggestions
• Documentation improvements

Code of Conduct

• Be respectful and constructive in all interactions.
• Focus on the problem, not the person.
• Assume good intent from other contributors.

Future Plans

As OpenWaggle matures, we plan to:

• Accept pull requests for bug fixes and features
• Publish a development setup guide
• Define code review and testing requirements for PRs

Questions?

Open a GitHub Discussion or reach out via the issue tracker.