Contributing to Mahalaxmi

Mahalaxmi is open source and contributions are welcome. Please read the guidelines below before submitting a Pull Request.

Contributor License Agreement (CLA)

All contributors must sign a Contributor License Agreement (CLA) before any Pull Request can be accepted. The CLA ensures that ThriveTech Services LLC holds the necessary rights to distribute your contributions as part of the project, and that you retain copyright over your own work.

The CLA bot will prompt you to sign when you open your first PR. You only need to sign once — it covers all future contributions to the Mahalaxmi repository.

What Contributions Are Accepted

The following contributions are accepted without prior discussion:

• Bug fixes — reproducible bugs with a test case demonstrating the fix.
• Provider plugins — new AI CLI adapters implementing the Provider Plugin SDK interface.
• Documentation — corrections, clarifications, and additions to existing docs.
• Minor improvements — performance fixes, code cleanup, and dependency updates.

The following require an issue or discussion before you start work:

• Core orchestration engine changes — open an issue first to discuss the design.
• New consensus or merge strategies — architectural discussion required before implementation.
• Breaking API changes — requires maintainer sign-off on the migration path.

How to Submit a Pull Request

1. Fork the repository on GitHub.
2. Create a feature branch: git checkout -b feat/your-feature-name
3. Implement your changes and write tests for any new code paths.
4. Run the full test suite and ensure it passes.
5. Open a Pull Request targeting the main branch with a clear description of the change.

Code of Conduct

Mahalaxmi is committed to providing a welcoming and respectful environment for all contributors. We expect all participants to:

• Use welcoming and inclusive language.
• Respect differing viewpoints and experiences.
• Accept constructive criticism gracefully.
• Focus on what is best for the community and the project.
• Show empathy toward other community members.

Harassment, personal attacks, and discriminatory behavior of any kind will not be tolerated. Violations may result in removal from the project.

Full Guidelines

See CONTRIBUTING.md on GitHub for the complete contribution guidelines, including commit message conventions, testing requirements, and release process.

Questions about contributing? support@mahalaxmi.ai