Reporting TUI problems

The TUI can package the details support needs without attaching your full configuration, environment, or conversation by default. You choose every diagnostic category before anything is saved or sent.

Open the reporter in either place:

• Run /report-bug from the conversation.
• Press F5 to open the backend console, then press r.

The reporter works without a network connection. Sending requires an authenticated profile and a deployment with feedback delivery configured; saving a local bundle does not.

1. Describe the problem

Fill in a short title, the steps that reproduce the problem, what you expected, and what actually happened. Additional context is optional.

Turn on Dreadnode may contact me about this report only if you want follow-up. Without consent, the stored support record and delivery summary use an anonymous placeholder instead of your profile name and email.

Press Review diagnostics or Ctrl+Enter when the report is ready.

2. Review the bundle

The review shows each category, its size, and whether it may contain customer content. Every checkbox can be cleared, including the safe defaults.

Category	Default	What it contains
System and runtime	On	Dreadnode and runtime versions, OS and architecture, terminal indicators, runtime and deployment mode, active screen, session ID, selected agent and model, and enabled capability names and versions
Recent logs (INFO/DEBUG)	On	A bounded snapshot of recent TUI and runtime logs, excluding TRACE entries
Latest exception	On when available	The most recent error or traceback
TRACE logs	Off	Verbose runtime events that may contain prompts or model payloads
Conversation content	Off	The active session transcript, including model and tool content
Worker logs	Off	Current capability worker logs
MCP logs	Off	Current MCP server logs
Persistent and previous logs	Off	The current persistent TUI self-log and two newest TUI, worker, or MCP rotations

The default bundle does not include config.yaml, mcp-auth.json, the raw environment, or the full conversation. Archives have a 2 MiB compressed limit and include a readable manifest.json plus the report text, selected diagnostics, sizes, checksums, and truncation markers.

Optional diagnostics can contain customer data

TRACE, conversation, worker, MCP, and rotated logs are off by default because they can contain prompts, model output, tool payloads, or data handled by a capability. Select them only after reviewing what the category represents.

3. Save or send

Choose one of these paths from the review:

• Save bundle writes dreadnode-report-<timestamp>-<hash>.zip under ~/.dreadnode/logs/. This works offline and does not authenticate or contact the platform. You can also press Ctrl+S.
• Send report uploads the reviewed bundle to your configured deployment. The button remains disabled when you are offline, unauthenticated, or feedback delivery is not configured.

Submission returns a stable receipt such as RPT-12AB34CD56EF78AB, a delivery state, and the date the stored report expires. Keep the receipt when following up with support. A stored or partial state means the report is safely retained but one or more configured delivery destinations did not complete; it is not presented as a successful delivery.

If upload fails, the reporter stays open and offers local save. No report is shown as sent unless the server first stores it durably.

Self-hosted deployments

Most self-hosted deployments leave feedback delivery unconfigured, so Send report stays disabled. Save bundle is the supported path: the archive is redacted, self-contained, and safe to move over email or a ticket system.

• Users — hand the saved dreadnode-report-*.zip to your platform operator.
• Operators — attach TUI bundles when escalating to Dreadnode support, alongside a support bundle when the platform itself is misbehaving.

How report data is protected

Credential-like values are redacted once while the TUI builds the archive and again after the server receives it. The server also rejects malformed, encrypted, oversized, non-text, or path-traversing archive entries.

Accepted reports are kept in private deployment object storage for 365 days. Configured internal issue delivery receives the report summary, receipt, and a time-limited private bundle link—not raw log text pasted into the issue. A self-hosted deployment does not send reports to Dreadnode or another external system unless its operator explicitly configures feedback delivery and you choose Send report.

When the TUI exits unexpectedly

The TUI continuously writes a bounded ~/.dreadnode/logs/tui.log self-log and retains the two newest rotations. The self-log records DEBUG-and-above entries only; TRACE-level content, which can include prompts and model payloads, is never written to disk. Restart the TUI, open /report-bug, and opt into Persistent and previous logs if those earlier records are relevant. You can still clear that checkbox and save or send the rest of the report.