Contributions

Issues, ideas, and pull requests are all welcome.

Found a bug?

Open a GitHub Issue and include enough that someone else can reproduce it: what you expected, what actually happened, and a minimal config + agent + prompt that triggers it. A log snippet from ~/.local/state/hyprpilot/logs/ helps a lot too.

Have an idea?

Discussions is the right place for "would this fit?" or "how would you do this?" — anything where you're sketching rather than reporting. If the conversation lands on something concrete, we can move it to an issue from there.

Sending a pull request

Fork, branch, push, open a PR against main. That's it. Smaller PRs are easier to review and land — one logical change per PR if you can swing it. Don't worry about getting the commit history perfect; we can tidy it on the way in.

If you're not sure your idea will be accepted, open a Discussion or Issue first to sanity-check the direction. Saves everyone time.

Building from source

See Development for the toolchain and task dev loop.