Thanks for your interest in contributing! This document explains how to submit changes and report issues.
- Fork the repository
- Create a feature or fix branch from
develop - Make your changes
- Open a pull request against
develop
- Every PR must be linked to a GitHub issue. Reference it in the PR description using
Closes #123,Fixes #123, orResolves #123. PRs without a linked issue cannot be merged. - Target the
developbranch. Do not open PRs againstmain. - Rebase onto
developbefore requesting a review. We require linear history — merge commits are not allowed. - All commits are squash-merged. Your PR title and description become the final commit message, so make them clear and descriptive.
- At least one approving review is required before a PR can be merged.
Please use the Bug Report issue template. You will need to provide:
- Your Wingman AI version
- Your
Wingman.yamlconfiguration file - Your
settings.yamlfile - A log file from the session where the bug occurred
- Clear steps to reproduce the issue
Never include your
secrets.yamlfile. It contains API keys and other sensitive credentials.
All of these files can be found in your %APPDATA%/ShipBit/WingmanAI/ directory on Windows.
Use the Feature Request issue template. Describe what you'd like to see and why it would be useful.
If you're planning to develop a major feature or new integration, please reach out on Discord first. We want to make sure your work aligns with the project's direction and doesn't overlap with something already in progress.
Be respectful and constructive. We're all here to make Wingman AI better.