# Send feedback and bug reports

> Report a bug, ask a question or suggest an idea from ShowTake or through your coding agent, with recordings, screenshots and diagnostics you choose to attach.

Source: https://showtake.app/docs/feedback

Bug reports, questions, ideas and praise go straight to the ShowTake team. You see everything before it is sent, and nothing leaves your Mac until you press **Send**.

## From the app

Open **Help → Send Feedback…** (also in **Settings → Privacy** and the menu bar icon).

1. Pick the kind: **Bug**, **Idea**, **Question** or **Praise**, and write what happened. For a bug: what you did, what you expected, and what happened instead.
2. Add an email address if you want a reply (optional).
3. Attach evidence: drop files on the window or use **Add Files…** (screen recordings, screenshots, logs, JSON, YAML, PDF, ZIP), **Attach a Take** (the take's video, latest render, flow, `render.json` and `events.json`), **Screenshot of ShowTake** or **Crash Reports** (ShowTake's own, with your user name removed). Remove anything with the ✕ next to it.
4. Open **What will be sent** to read the exact report, including the diagnostics, and turn diagnostics off if you prefer.
5. Press **Send**. Large videos upload with a progress bar. You get a reference like `FB-7K2Q-9MXA`; quote it if you write to us about the report.

No connection? The report is saved on your Mac and sent automatically when ShowTake can reach showtake.app again, even after a restart.

## Through your coding agent

Ask your agent to report it ("send this bug to ShowTake with the last take"). It calls the MCP tool `send_feedback` with a description, the take or files, and the diagnostics. ShowTake then opens the same **Send Feedback** window, marked as prepared by your agent: check it, change anything, and press **Send**, or close it to cancel. Your agent learns whether you sent it and gets the reference.

```json
{
  "kind": "bug",
  "message": "end_take reports clean=false on step 3 (element_not_found: Save). Replay of flow add-item fails the same way.",
  "attachments": [{ "take_id": "2026-11-12-0930-add-item", "include": ["raw", "flow", "render"] }],
  "screenshot": true
}
```

The call waits up to 90 seconds for you (`wait_seconds`, at most 300) and answers `sent` with the reference, `cancelled`, `queued` (offline, sent later) or `awaiting_user` with a `draft_id` the agent can check again. Parameters: [MCP tool reference](https://showtake.app/docs/tools#send_feedback).

## What a report contains

- Your message, the kind and your reply email if you gave one.
- ShowTake's version and update channel, the macOS version, the Mac model and processor type, your license plan and state (never the key), and which coding agent prepared it.
- Diagnostics, unless you turn them off: ShowTake's setup check (Xcode, simulator runtimes, disk space, permissions, versions), its recent log of tool calls and errors, and summaries of ShowTake's crash reports. Your home folder and user name, email addresses, license keys and tokens are removed before the report is built.
- Only the files you attached.

## Limits

| | Limit |
| --- | --- |
| Attachments per report | 20, 1 GB in total |
| Videos (`.mov`, `.mp4`, `.m4v`, `.webm`) | 500 MB each |
| Images (`.png`, `.jpg`, `.heic`, `.gif`, `.webp`) | 25 MB each |
| Text, logs, JSON, YAML, CSV, crash reports | 10 MB each |
| PDF / ZIP | 50 MB / 200 MB |
| Reports | 20 per day per Mac |

Zip folders before attaching them. For anything larger, send the report without the file and we will reply with a way to share it.

## Privacy

Reports are private: they are stored where only the ShowTake team can read them and are deleted after 180 days. Recordings never leave your Mac unless you attach them here and press Send. Details: [privacy policy](https://showtake.app/privacy#feedback-you-send).

Prefer to discuss it in public? **Help → Open a Public GitHub Issue…** opens a pre-filled issue you write and publish yourself.