FAQ

Questions, answered.

How Boughwright works with your accounts and your git, which Macs it runs on, and how the one-time license works.

About Boughwright

What is Boughwright?

Boughwright is a native git client for macOS. Point it at the folder where you keep your code and it lists every git repository inside, with each one's branch, changed files and ahead/behind counts. It also lets you pick which GitHub account commits and pushes in each repository.

How does Boughwright use my GitHub accounts?

Each account stores a token in your macOS Keychain, plus the name and email you want on commits. When you commit, Boughwright passes that name and email to git for that one commit. When you push, pull or fetch, it gives git that account's token for github.com only, so other hosts keep using your normal credentials. Your global ~/.gitconfig is never changed.

Do I sign in with a token or with the browser?

Either one. Sign in on GitHub with a one-time code, or paste a personal access token with the repo, read:org and user:email scopes. GitHub Enterprise hosts work too.

Does it replace the git I already have?

No. Boughwright runs your installed git: Homebrew's if you have it, otherwise Apple's. Hooks, Git LFS, commit signing and aliases keep working exactly as they do in Terminal.

Which Macs does it run on?

macOS 14 Sonoma or later, on Apple silicon and Intel Macs. It's a native SwiftUI app.

Does Boughwright work with GitLab or Bitbucket?

Yes for everyday git work: status, staging, commits, branches, history, push and pull work with any remote. Account switching with stored tokens is built for GitHub and GitHub Enterprise. For other hosts, Boughwright uses the credentials git already has.

GitHub accounts

Can I use two GitHub accounts on the same Mac?

Yes. Connect both accounts in Boughwright and choose one per repository. Commits use that account's name and email, and pushes use its token, without editing ~/.gitconfig or ~/.ssh/config.

How do I stop committing to work repositories with my personal email?

Assign your work account to the work repositories. Boughwright does this automatically when the remote belongs to your work organisation, and it shows the account right above the Commit button so you can see which identity you're about to use.

Do I still need SSH host aliases like github-work?

No. You can give each account its own SSH key, or let Boughwright send git@github.com remotes over HTTPS with that account's token. Your remotes can stay as plain git@github.com URLs.

Where are my tokens stored?

In the macOS Keychain. They're passed to git through environment variables for a single command, so they never appear in a config file or in the process list.

Pricing and licenses

Is Boughwright free?

Yes. The free version includes every git feature, one workspace folder and two GitHub accounts, with no time limit. Pro adds unlimited accounts and folders, Fetch All, Pull All and background fetch.

How much does Boughwright Pro cost?

Pro is a one-time payment of $39 that includes one year of updates. There's no subscription. After the first year you can renew updates for $19 a year, but you don't have to.

What happens when my year of updates ends?

Nothing breaks. Every version released during your year stays Pro forever. Newer versions run in Free mode until you renew for $19, which adds another year of updates.

Can I use one license on my laptop and my desktop?

Yes. A license is for one person, on all of their own Macs.

Does the license need an internet connection?

No. License keys are verified offline with a digital signature, so Boughwright never phones home to check your license.

Boughwright app icon

Tidy up your git.

Download Boughwright free, point it at your code folder, and connect your accounts. It takes about a minute.