How to Capture Logs for a Bug Report

Use this when PaceBar is not working and you need to share debug info.

• Audience: non-technical users
• Time: ~2 minutes
• Platform: macOS

1) Set log level to Debug

1. In your macOS menu bar, find the PaceBar icon.
2. Right-click it (or hold Control and click).
3. Open Debug Level.
4. Select Debug.

If PaceBar does not open at all, skip this step and continue.

2) Reproduce the issue once

1. Do the action that fails.
2. Wait for the failure to happen.
3. Stop after 1-2 attempts (enough data, less noise).

3) Open the log folder in Finder

1. Open Finder.
2. Press Shift + Command + G.
3. Paste this path:

~/Library/Logs/dev.cbnsndwch.pacebar

4. Press Enter.

4) Attach log files to your GitHub issue

1. Attach pacebar.log.
2. If you also see files like pacebar.log.1, attach those too.
3. Drag the files directly into your issue/comment on GitHub.

5) Add this context in the same issue comment

Copy/paste and fill:

What I expected:
What happened instead:
When it happened (local time + timezone):
Which provider was affected (Codex / Claude / Cursor / etc.):
PaceBar version:

Privacy note

Logs are redacted for common secrets, but still review before sharing in public.

Optional: switch log level back

After sending logs, set Debug Level back to Error.