Skip to content

Phase 6: CLI --debug diagnostic bundle and bug-report issue form #1256

Closed

Description

@neuromechanist

Part of #1250. Independent of Phases 1-5.

Users should be able to hand us what we need to diagnose a failure without a screenshot exchange (#1249 took three emails).

  • Global --debug flag and NEMAR_DEBUG=1: writes ~/.config/nemar/logs/nemar--.log with CLI version, OS and arch, Bun version, active account (username, API URL, role, tier, sandbox; never the key), external tool versions (git, git-annex, gh, aws, deno), each HTTP request and response (method, URL, status, duration, redacted headers, body truncated and with tokens/keys/emails masked), the failing step, and the exit code. Keeps the last 10 logs.
  • On any non-zero exit the CLI prints one line: Run again with --debug and attach the log at https://github.com/nemarOrg/nemar-cli/issues/new?template=bug_report.yml (suppressed under --json).
  • Replace .github/ISSUE_TEMPLATE/bug_report.md with bug_report.yml (issue form): what happened, expected, steps, nemar --version output, OS, a required Debug log field with the --debug instructions, and a checkbox confirming the log was reviewed for personal data. Keep feature_request.md.
  • nemar doctor gains --report which prints the environment section of the same bundle.
  • Tests: redaction (API key, Bearer header, email, S3 secret), log rotation, hint printed on failure and suppressed with --json.

Activity

  1. neuromechanist commented on Sep 5, 2026

    @neuromechanist
    ContributorAuthor

    Landed on the epic branch via #1257 (squash a5969ad). Reaches dev with the epic PR for #1250. Follow-up for wider failing-step capture: #1259.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    cliCLI relatedfeatureNew feature or enhancement

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions