doc/devdocs/commands.md
The PowerToys repository uses some special keywords to help manage issues and pull requests. Here is a list of the most important commands you can use in issue and PR descriptions or comments.
| Command | Description |
|---|---|
/azp run | Triggers the Azure Pipelines CI build for the current PR. Useful if you want to re-run the build without creating a new commit. |
/bugreport / /reportbug | Adds a comment with a manual for the Bug Report Tool, which helps users collect logs and system information for debugging purposes. It requests to upload this file and adds the Needs-Author-Feedback label. |
/feedbackhub | Adds a comment with a link to the Feedback Hub app on Windows, where users can submit feedback about PowerToys. Closes the issue and adds the Resolution-Please File on Feedback Hub label. |
/dup #... / /duplicate #... / /dup https://... / /duplicate https://... | Marks the current issue as a duplicate of another issue. It closes the current issue and applies the Resolution-Duplicate label. Replace #... with the issue number or a link to the issue. |
/needinfo | Adds the Needs-Author-Feedback label to the issue or PR, indicating that more information is needed from the author. |
/helped | Closes the issue and adds the Resolution-Helped User label. Furthermore a comment is added with a link to the PowerToys user documentation. |
/loc | Adds a comment informing the user that the issue was forwarded to the localization team and will soon be fixed. It adds the Loc-Sent To Team label. |
Most of these commands are using the Microsoft GitHub Policy Service bot. Its commands are defined in the PowerToys policy configuration file.
New and updated issues are processed by a GitHub Agentic Workflow that combines
deterministic checks with a bounded GitHub Copilot pass. It maintains one
triage comment, adds a matching primary Product-* label and version label,
requests blocking author information, recommends updating older PowerToys
versions, surfaces likely duplicates, and analyzes a sanitized subset of
attached PowerToys diagnostic reports.
Duplicate closure is submitted as a native GitHub suggestion. A maintainer must accept or decline it. Accepting the suggestion closes the issue as a duplicate and links it to the selected canonical issue.
Needs-Author-Feedback labelIf an issue or pull request retains this label without activity for 7 days, the bot closes it. An author comment removes the label from issues and pull requests, and an author push removes it from pull requests. Removing the label manually also disables scheduled closure.
If a user utters their intention to contribute (e.g., by using the phrase "I want to contribute" in an issue or PR), the bot will add a comment with a link to the "Would you like to contribute to PowerToys?" thread.