Complaintr Docs

GitHub

Core answers people who mention it in your repository's issues and pull requests.

If your product has a public repository, link it to a project. Anyone who mentions @complaintrbot in an issue or pull request comment gets an answer from Core, can file a complaint, or can be passed to a person.

Connect a repository

Open in Complaintr
  1. Create at least one project in Projects.
  2. In the sidebar, open Integrations, choose GitHub Issues, then click Connect a repository.
  3. Install the Complaintr GitHub App on the repositories you want to monitor and return to Complaintr.
  4. Choose a Complaintr project from Select project.
  5. Click Link beside each repository that should report to that project.
  6. Mention @complaintrbot in an issue or pull request comment and describe the problem. The assistant asks any follow-up questions and files the complaint after you confirm in a reply that also mentions the bot.

You need both the GitHub App installation and a repository link. Several repositories can point to the same project. To stop, open Integrations > GitHub Issues and unlink the repository.

Talk to the bot

Mention the bot and write in plain words. There are no commands.

GitHub comment
@complaintrbot Exporting a report to PDF fails when it has more than 50 rows.
The download starts and then stops with an empty file.

The bot replies on the thread, asks follow-up questions, and shows a summary. To approve or decline, write a new comment that mentions the bot and says yes or no. Mentions inside code blocks are ignored.

Complaints include the repository, the issue or pull request, and a link to the comment. When Core passes a message to a person, it links the thread under Needs follow-up, so you can answer there.

Images and videos

Paste a screenshot or a screen recording into the comment that mentions the bot. It reads images and videos uploaded to GitHub, in public and private repositories, while it writes the complaint. Up to 4 images (PNG, JPEG, GIF, or WebP, 10 MB each) and 1 video (MP4, MOV, or WebM, 50 MB) per message. A video reaches the assistant without its sound. The files appear under Attachments on the complaint.

Test it

Mention the bot on a linked repository, approve the summary in a new mention, and find the complaint in the Inbox with the GitHub source.

On this page