List bug reports stored by bugcap, newest first. Use this to find a report id; it returns only summaries (id, title, status, tags, repo, created_at, linked GitHub issue) and no notes or images, so call get_report for the full report. Read-only and local: no network access. Returns a JSON array, empty when nothing matches.

Read one bug report in full: title, body, notes, status, tags, linked GitHub issue and the list of attached media, followed by every screenshot as image content so you can see it. Use this after list_reports to understand a bug before fixing it. Notes refer to media as @i1, @d1 or @label; resolved_references maps each of those tokens to its media index. Read-only and local. Returns {"error": ...} when no report has this id.

Ask the human at the machine to take a screenshot (for example to show a bug, or to check a fix) and attach it to a report. Use this when you need visual evidence you cannot produce yourself; to attach an image file that already exists, use attach_image. Opens the user's capture tool and blocks until they finish, cancel or timeout_seconds passes. Adds the image to the report (and creates a report for issue if needed). Returns {"status": "captured", "report_id"} plus the screenshot as image content, or a status of "cancelled", "error" or "non_interactive" (no desktop available, e.g. over SSH or in a container) with a message.

Import open GitHub issues into bugcap as reports, so you can read them with get_report and attach screenshots to them. Use this when the bug you need lives in GitHub rather than in bugcap yet. Calls the GitHub API through the user's gh login. Safe to repeat: an issue that is already imported only has its title and body refreshed, never its notes, tags or status. Returns {"created", "updated", "unchanged"} counts, or {"error": ...} when no repo is given or configured, or gh is not signed in.

Add existing images (PNG, JPEG, GIF or WebP) to a bug report, for example a screenshot you saved or a diagram from a URL. Use attach_file instead for logs, videos or other non-image files, and request_screenshot when the user has to take the picture. Copies each image into bugcap's local store (URLs are downloaded) and appends it to the report; existing media is kept. Notes can then refer to it as @i or @label. Returns {"added": [{index, label, kind, size_bytes, source}], "rejected": [{source, reason}]}: one bad source does not stop the others.

Add files of any type (logs, stack traces, HAR captures, videos, configs) to a bug report as supporting evidence. Use attach_image for pictures so they are returned as images by get_report. Copies each file into bugcap's local store (URLs are downloaded) and appends it to the report; existing media is kept. Attached files are never uploaded to GitHub. Notes can then refer to a file as @d or @label. Returns {"added": [...], "rejected": [{source, reason}]}: one bad source does not stop the others.

Overwrite a bug report's notes with new text, for example to record a diagnosis, steps to reproduce or what a fix changed. The previous notes are replaced, not appended to: read them with get_report first and include whatever should be kept. Every @ reference must match media attached to the report; an unknown one is rejected with an error and nothing is saved. #12 links another report; one that does not exist is kept and listed in warnings. Local only. Returns {"report_id", "notes", "references", "warnings"}.