> ## Documentation Index
> Fetch the complete documentation index at: https://runmaestro-feat-autonomous-manager-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Feedback

> Submit bug reports and feature requests through Maestro's conversational feedback system.

Maestro includes a built-in feedback system that uses AI to help you craft well-structured GitHub issues. Instead of filling out a form, you have a short conversation - the AI asks clarifying questions, checks for duplicates, and submits a polished issue on your behalf.

## Prerequisites

* [GitHub CLI](https://cli.github.com/) (`gh`) must be installed
* You must be authenticated (`gh auth login`)

## Sending Feedback

### 1. Open the Feedback Modal

Click the **Feedback** button in the bottom-left corner of the sidebar, next to **New Agent**.

<img src="https://mintcdn.com/runmaestro-feat-autonomous-manager-agent/iBS3RdDhE8nLt8iH/screenshots/feedback-0.png?fit=max&auto=format&n=iBS3RdDhE8nLt8iH&q=85&s=d20bfcf8bdd991233e155229f49be40f" alt="Feedback and New Agent buttons" width="752" height="102" data-path="screenshots/feedback-0.png" />

You can also open it via **Quick Actions** (`Cmd+K` / `Ctrl+K`) → "Send Feedback".

### 2. Choose an AI Agent

Select which installed AI provider will conduct the feedback conversation. Maestro auto-detects available agents (Claude Code, Codex, OpenCode) and pre-selects the first one found.

<img src="https://mintcdn.com/runmaestro-feat-autonomous-manager-agent/iBS3RdDhE8nLt8iH/screenshots/feedback-1.png?fit=max&auto=format&n=iBS3RdDhE8nLt8iH&q=85&s=b541bd39c8152456e097a77a473590fd" alt="Agent selection" width="926" height="752" data-path="screenshots/feedback-1.png" />

Click **Start** to begin.

### 3. Describe Your Issue

Tell the AI what's on your mind - a bug you hit, a feature you want, or general feedback. The AI classifies your input and asks targeted follow-up questions:

* **Bug reports** - What happened? What was expected? Steps to reproduce?
* **Feature requests** - Use case? Desired outcome? Why it matters?

A confidence bar at the top tracks how well the AI understands your issue. As you answer questions, it fills toward 100%.

<img src="https://mintcdn.com/runmaestro-feat-autonomous-manager-agent/iBS3RdDhE8nLt8iH/screenshots/feedback-2.png?fit=max&auto=format&n=iBS3RdDhE8nLt8iH&q=85&s=fdb0fdff399cdbd19e47f65d0ea042c4" alt="Feedback conversation" width="1720" height="1438" data-path="screenshots/feedback-2.png" />

**Optional attachments:**

* Drag and drop up to 5 screenshots (PNG, JPG, GIF, or WebP - 10 MB each)
* Check **Include support package** to attach debug information

### 4. Review and Submit

Once understanding reaches **80%**, a green **Submit Feedback** button appears. The AI presents a structured summary of what it will submit. Review the summary, tweak anything by continuing the conversation, then click **Submit**.

<img src="https://mintcdn.com/runmaestro-feat-autonomous-manager-agent/iBS3RdDhE8nLt8iH/screenshots/feedback-3.png?fit=max&auto=format&n=iBS3RdDhE8nLt8iH&q=85&s=6b6a3a1d67b7bb4587c040c49866e645" alt="Submit feedback" width="1710" height="1850" data-path="screenshots/feedback-3.png" />

### Duplicate Detection

As you describe your issue, Maestro searches existing GitHub issues in the background. If similar issues are found, an inline card appears listing them. You can:

* **Subscribe to an existing issue** - Your context is added as a comment with a +1 reaction
* **Create a new issue anyway** - Bypasses the match and files a fresh issue

This prevents duplicate reports while still capturing your unique context.

### After Submission

Once submitted, you'll see a confirmation with:

* A direct link to the new GitHub issue
* A copy-to-clipboard button for the issue URL
* An option to open the issue in your browser