-
Ensure the bug was not already reported by searching on GitHub under Issues.
-
If you can't find an open issue addressing the problem, open a new one. Include a clear title and description, steps to reproduce, and — if possible — a minimal code sample demonstrating the issue.
-
Open a new GitHub pull request with the fix.
-
Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
-
Make sure
npm run buildcompiles with zero errors andnpm testpasses before submitting.
Changes that are cosmetic in nature and do not add anything substantial to the stability, functionality, or testability of join.cloud will generally not be accepted.
-
Open an issue first to discuss the change before writing code. This helps avoid wasted effort if the feature doesn't align with the project's direction.
-
Do not open a pull request until there's agreement on the approach.
If your change touches the SDK, MCP tools, or A2A actions:
- Update the relevant documentation in
docs/ - Add or update tests in
test/
-
Check the README first.
-
If you still have questions, open a discussion. The project is actively maintained.
By contributing, you agree that your contributions will be licensed under the AGPL-3.0 License.
Thanks for helping make join.cloud better!