Documents
05 - Logs and Diagnostics
05 - Logs and Diagnostics
Type
Document
Status
Published
Created
May 26, 2026
Updated
May 26, 2026
Template

What to collect#

Good diagnostics include the action you took, the repository or workspace involved, the selected agent, the error text, and the relevant log window.

Log areas#

  • App logs for frontend and Tauri behavior.
  • Sidecar logs for agent provider sessions.
  • Git output for branch, worktree, and repository failures.
  • Test output when a development change is involved.

Development logging#

Use HELMOR_LOG=debug when you need more detail from a local development run.

Report shape#

When filing an issue, include steps to reproduce, expected behavior, actual behavior, app version or commit, operating system, and the smallest useful log excerpt. Avoid posting secrets, tokens, or private repository content.