Report a problem

When something breaks, ZenTerm files the report from inside the app. There is no account and no backend. The app builds a prefilled issue and opens your browser to the public tracker.

Report an Issue

Open the composer from Help → Report an Issue, from the bottom of Settings, or from the command palette on P. Give it a title and what happened, and it shows the environment it will attach: the app version, your macOS version, and the architecture. Submit it and ZenTerm opens a prefilled issue on the public GitHub tracker.

The composer ships without a shortcut. Bind the report_issue action in Settings under Shortcuts, or in your keybinds, to put it on the keyboard.

Export Diagnostics

Help → Export Diagnostics saves a zip of your logs and system info to attach to a report. Drag the zip into the issue and the logs travel with it.

The diagnostic log

ZenTerm writes a rotating log to ~/Library/Logs/ZenTerm/zen-term.log. By default it holds warnings, errors, and a trail of key actions: panes, tabs, and drawers.

For a harder bug, turn on the verbose gate to add deep traces. Set debug = true in your config, or launch ZenTerm with ZENTERM_LOG_VERBOSE=1. Export Diagnostics then carries the fuller log.