Settings

Command+, (Ctrl+,) opens Settings. On macOS it is also under the PwrGit menu; elsewhere it is at the top of the File menu.

Seven panes: General, Updates, Profiles, Forges, Experimental, Memory / CPU, and About. The defaults are the recommendation — each “why you might change it” below is the rarer case.

General

Sidebar

Two independent axes.

Text size — XS (11px), S (12px), M (13px), L (14px), XL (15px). It scales the repository names in the sidebar, with worktree branches one step down. Counts, tags and section labels deliberately hold still, so a larger size reads as bigger names rather than as zooming the whole app.

Density — Comfortable or Compact. Controls row padding and the gaps between repositories. It is independent of text size; Compact with a large text size is a perfectly good combination.

Developer mode

Off. Turning it on exposes Reload, Force Reload and Developer Tools in the View menu, and enables their shortcuts (Command+R, Shift+Command+R, Option+Command+I). It takes effect immediately in every window.

Leave it off unless you are debugging the app itself — the shortcuts are easy to hit by accident, and reloading mid-operation is not useful.

Updates

Release train — Stable or Beta. Update track — Latest or Prerelease. The defaults are Stable and Latest.

Each option shows the version currently in that slot, so you can see what switching would actually move you to. Unavailable means nothing has been published there yet; Beta stays selectable regardless.

Check for Update forces a check. When a build has downloaded, a Restart to Update (<version>) button appears here.

Full detail in Install → Updates.

Profiles

Lists every profile with its commit identity and repo folders, and marks the active one. Add profile creates one; Edit… changes a profile’s name, commit email, author name, and folders; Open window brings up its window.

There is no delete. PwrGit has no command for removing a profile.

See Profiles for what a profile is and why the commit identity is applied the way it is.

Forges

Reports GitHub and GitLab as Connected, Signed out, or Not installed, and lists what each one supports.

For a forge that is blocked, it names the exact command that unblocks it. For a working one, it lists its capabilities, so a feature that forge cannot do reads as a known limit rather than as a bug.

This pane re-checks while it is open, so signing in from a terminal updates it without reopening.

See Forges.

Experimental

Features that may change shape or be removed without notice.

Lineage Graph Scope — off. Turning it on makes newly opened worktree views default to All branches instead of Active. The toggle in the graph header still overrides it per view either way.

Turn it on if you routinely work across many branches at once and find yourself flipping the scope every time. See Scope.

Memory / CPU

Diagnostic profiling. All of it is off, and all of it exists for chasing a performance problem — turn something on when someone asks you for a profile, and turn it back off afterwards.

Heap Monitor — samples the main process and every window’s heap on an interval, and captures a heap snapshot automatically when usage jumps by more than a growth threshold. Starts and stops live.

Hot Renderer CPU Profiling — watches each window’s CPU usage and captures a CPU profile of a renderer that stays above the trigger threshold. Arms and disarms live. It has three controls:

• Start delay — wait before sampling begins, so you have time to stage the scenario you want profiled.
• Trigger mode — Spike fires on a single hot sample, Sustained needs consecutive hot samples, and Slow burn lowers the threshold to catch steady background churn.
• Heap snapshots during profiles — brackets each CPU profile with renderer heap snapshots. It turns itself off once a session reaches the snapshot limit, because snapshots are large.

Startup CPU Profiling — profiles the main process and the first window from launch until shortly after first paint. Unlike the others this applies on the next launch, and stays on for every launch until you turn it off.

Output is written into the application data folder, and the pane has a control to reveal it in your file manager.

About

The installed version, and attribution: PwrGit is released under the MIT License, with Third-party notices for its dependencies. Both open from here, and from the Help menu.