Thanks for your interest in contributing! ClawFleet is an open-source project and we welcome contributions of all kinds.
- Bug reports — found something broken? Open an issue
- Feature requests — have an idea? Open an issue
- Code — pick an issue labeled
good first issueorhelp wanted - Documentation — improve the Wiki, fix typos, add examples
- Testing — try ClawFleet on your setup and report what works or doesn't
# Clone the repo
git clone https://github.com/clawfleet/ClawFleet.git
cd ClawFleet
# Install dependencies
go mod tidy
# Build
make build
# Run tests
make test- Fork the repo and create a branch from
main - Make your changes — keep the PR focused on one thing
- Run
make testandmake vetbefore submitting - Open a PR with a clear description of what and why
- A maintainer will review and provide feedback
- Follow standard Go conventions (
gofmt,go vet) - Keep functions focused and small
- Add comments only where the logic isn't self-evident
- Don't add features, abstractions, or cleanup beyond the scope of your PR
See CLAUDE.md for the full architecture overview. Key rule: product layer (web/, cli/) → infrastructure layer (container/, state/, port/, config/) — never reverse the dependency.
By contributing, you agree that your contributions will be licensed under the MIT License.