Preferences

Find and change Preferences

Preferences has a page per area, such as General, Profiles, SSH, Integrations, Nour (AI), External Tools and UI Customization, plus Repo-Specific Preferences for each open repository. Search preferences finds a setting by name, description or key, and each setting says where it Saves to: App, Profile or Repository.

Appearance and language

Preferences › UI Customization sets the Theme (light, dark and high-contrast versions), Follow the system appearance, the Language (English or Arabic, laid out right to left), Zoom, how Dates are shown and Reduce motion.

Configure Git and repository behavior

Preferences › General holds how GitTree drives Git: the Git executable, Pull mode, Auto-fetch interval, rebase options, Long paths and Line endings. Repo-Specific Preferences overrides some of them for one repository, such as its Base branch, auto-fetch, commit template and how it notices file changes.

Manage Git identities and profiles

A profile is a name and email for commits, plus an optional signing key and SSH command, that you can switch between. By default it is Passed to each git command GitTree runs, so ~/.gitconfig is never changed and a repository’s own name or email still wins; Written to ~/.gitconfig makes every git tool use it.

Configure SSH in GitTree

Preferences › SSH lists the keys in your .ssh folder, creates new ones, shows each host from your SSH configuration and tests a connection. GitTree never starts an SSH agent and never edits ~/.ssh/config or core.sshCommand; a key you choose for SSH remotes is passed to git commands it runs.

Configure commit and tag signing

Preferences › Commit Signing picks the Format (OpenPGP, SSH key or X.509) and Key, and whether to Sign every commit and Sign every annotated tag. Nothing is written until you press Apply to Global Git Config. The graph and commit details then show each commit’s signature state.

Configure tools and file encoding

Diffs and files that are not UTF-8 are read with Preferences › Editor › Default encoding; a byte-order mark always wins, and bytes that do not fit show as �. Line endings (core.autocrlf) decides how git converts CRLF and LF, and Long paths lets git create paths over 260 characters on Windows.

Configure notifications and logging

Preferences › Notifications sets Where notifications appear, whether to Show success notifications, and Desktop notifications from your system. Extended logging in General writes more detail to the local log, from the next launch, to help diagnose a problem; nothing is sent anywhere.

Configure Nour privileges

Two settings bound Nour. What Nour may do in a repository sets what the agent itself may do there: Read only, Edit files, no commands or Everything, as in a terminal. What Nour may do in GitTree sets, for each kind and area of app action, Never, Ask me first or On its own; risky changes always ask.

Configure integration refresh

Preferences › Integrations controls how GitTree reads your hosting accounts: how old the lists may get before Refresh pull requests, issues and checks, whether to Refresh when I come back, CI/CD log defaults, and where author pictures come from. Reading happens only while GitTree’s window is in front.

Back up, import or reset settings

Preferences › General › Back up, restore and reset exports your app settings, profiles and git settings to a file, imports such a file, or resets everything. An export never contains passwords, tokens or account details, nor any repository’s settings. Git settings from an import are written to ~/.gitconfig only after you review them.

Check for and install updates