How can we help?

Click the Pegboard icon in your menu bar to toggle the panel open or closed. You can also use the default global hotkey ⌥ + Space from anywhere on your Mac.

To change the hotkey, click the ✏️ Edit button in the top corner of the panel to enter Edit Mode. Once in Edit Mode, the Pegboard menu will appear at the top-left of your screen. Go to Pegboard → Settings (⌘ + ,) and navigate to the Shortcuts tab.

Click the ✏️ Edit button in the panel to enter the layout editor. From there, click the + Add Widget button in the toolbar to browse all available widgets and add them to your grid.

You can reorder widgets in the editor by dragging them, and adjust their size through each widget's individual configuration panel. The layout is saved automatically as you make changes.

Enter Edit Mode by clicking the ✏️ Edit button in the panel. In the editor:

To move: Click and drag the widget to a new position in the grid. It will snap to the nearest cell.

To resize: Click the widget to open its settings panel, where you can select its width and height (calculated in grid cells).

Enter Edit Mode (click ✏️ Edit in the panel), then open Pegboard → Settings → Data and click Export Configuration. This saves a .pegboard file — a complete snapshot of your layout, settings, themes, and widget data — wherever you choose.

To restore it on the same or another Mac, enter Edit Mode and open Settings → Data → Import Configuration and select the file.

The Todo widget uses Apple's EventKit framework to read from and write to your system Reminders app. The first time you add a Todo widget, macOS will ask you to grant Pegboard access to Reminders — click Allow.

Tasks you create in the widget appear in Reminders and vice versa. Completing a task in Pegboard marks it as complete in Reminders too.

Data chart widgets read from a plain-text file on your Mac. To set one up:

1. Add a chart widget from the layout editor.
2. Open the widget's settings and click Choose File to select your data source.
3. Format your data as a single numeric value in a plain-text file. The widget reads the latest value whenever the file is saved — you should overwrite the file each time (do not append) to keep it lightweight.
4. The chart updates automatically whenever the file changes, using macOS file-system events — no polling or manual refreshing needed.

Data chart widgets require a Pro subscription or one-time purchase.

Add placeholders in double curly braces to your snippet text — for example: feat/{{ticket-id}}-my-feature.

When you click the copy button, Pegboard prompts you to fill in the value for each variable. The final string (with your input substituted in) is what gets copied to your clipboard.

Yes. The Stopwatch and Countdown timers continue running in the background when you dismiss the Pegboard panel. When you reopen the panel, the elapsed time will be accurate.

The Pomodoro timer also continues running in the background and will send a system notification when a focus or break phase ends (if you have notifications enabled).

First, make sure Pegboard is running (look for its icon in the menu bar). If it is running, try these steps:

1. Check for conflicts: Another app may be using the same hotkey. Enter Edit Mode (click ✏️ Edit in the panel), then open Pegboard → Settings and change the hotkey to something unique.

2. Re-register the hotkey: Quit Pegboard (enter Edit Mode, then choose Pegboard → Quit Pegboard from the system menu bar at the top-left) and relaunch it from your Applications folder.

Note: Pegboard uses a sandbox-compatible hotkey API and does not require Accessibility permissions.

This is usually a permissions issue. Go to System Settings → Privacy & Security → Reminders and make sure Pegboard is listed and enabled.

If Pegboard doesn't appear in the list, remove and re-add the Todo widget — macOS will prompt you to grant access again.

Data chart widgets monitor the selected file using macOS file-system events (FSEvents). If the widget stops updating:

1. Open the widget's settings and click Choose File to re-select your data source. This refreshes the app's link to the file and can often resolve update issues.

2. Check that Background refresh is toggled on in the widget's settings.

3. Try closing and reopening the Pegboard panel, or relaunching the app.

If the file is being written by a process that writes to a temporary file and then renames it (atomic writes), FSEvents may not always trigger — try saving the file in-place instead.

Enter Edit Mode (click ✏️ Edit in the panel), then open Pegboard → Settings → General and toggle on Launch at login. This uses macOS's built-in login item API — no background services or launch daemons are installed.

Alternatively, go to System Settings → General → Login Items and add Pegboard manually.