Reporting a problem

/bug prepares a problem report inside Mercury and files it in the repository through your own signed-in GitHub CLI, gh. By hand, the repository takes reports through its issue templates, and security problems through its Security tab.

Report routes

Short tester report: Use the tester form or /bug --short <what you tried> inside Mercury (also linked once per session on the leave card and farewell line). It asks for your operating system, what you tried and what broke; no health dump is required.
/bug <what happened>: Shows the exact report, then files it through your own signed-in gh.
Local draft: Without gh, the report stays a local draft under the config home, and Mercury names the repository's issues page.
Issue templates: The repository accepts a tester report, a bug report, a provider or model report, or a feature request. Blank issues are disabled, and the template chooser links to the documentation index.
Security tab: A security problem goes through the repository's Security tab and stays out of public issues.

Report a bug from Mercury

Enter /bug <what happened> with a description of the problem, then review the redacted report that Mercury shows before it is filed through your signed-in gh (or saved as a local draft under the config home when gh is unavailable).

Report a problem through an issue template

To report a problem through an issue template, open the repository's issues page, select the tester report, bug report, provider or model report, or feature request template, fill in the requested fields and submit the issue.

Requested information

Version: Every template asks for the --version line, as node dist/mercury.mjs --version or mercury --version prints it.
Environment: Every template asks for the operating system and the terminal host, with versions.
Steps: Every template asks for the exact steps, one per line.
Diagnostics: The bug and provider templates ask for the output of health --json, which contains no credentials.
Bug report: Also asks how Mercury was installed, what was expected and what happened instead. A pasted transcript of the failing screen helps; text is preferred over an image.
Provider or model report: Also asks for the provider family, the model row as /model shows it, where it happened, and the exact refusal or warning text pasted verbatim. Never paste an API key or a token.
Feature request: Asks for the task in your own words, what happens today, the behaviour wanted and where it belongs, and the steps to reach the gap.

Collect diagnostics

Run mercury health --json on a release install, or node dist/mercury.mjs health --json on a built source copy, and paste the output into the bug or provider report.

During the beta the repository takes issues instead of pull requests: a pull request from outside the collaborator set is closed with a pointer to an issue, and a change proposal goes in an issue with the diff pasted in. The repository's contribution guide states this and covers building and checking a change.

Report a security problem

To report a security problem:

Open the repository's Security tab.
Select Report a vulnerability.
Include the --version line, the output of health --json, the operating system and terminal, the exact steps with what was expected and what happened instead, and for a provider problem the provider family and the model row.

The private report thread is where the conversation continues.

Report security problems only through the Security tab. The latest release is the supported one; older releases receive no fixes, and the remedy is mercury update or a rebuild from the current source.

Health check · Command-line reference · Install and update · Providers and sign-in