Thank you for your interest in contributing to MOSShell! This document provides guidelines and instructions for contributing.
We welcome contributions! These guidelines exist to save everyone time. Following them means your work is more likely to be accepted.
All pull requests require a corresponding issue. Unless your change is trivial (typo, docs tweak, broken link), create an issue first. Every merged feature becomes ongoing maintenance, so we need to agree that it's worth doing before reviewing code. PRs without a linked issue will be closed.
- Make sure you have
Python 3.10+installed. - Install uv.
- Fork the repository and clone your fork.
- Install development dependencies:
make prepare. - Create a new branch and make your changes.
- Run formatting, linting, and tests before submitting a PR:
make format
make lint
make test- Update documentation as needed.
- Add tests for new functionality.
- Ensure CI passes.
- Address review feedback.