Getting Started

Gitfox works with normal local Git repositories. You can open an existing repository, clone one from a URL, or add a hosted-service account and clone from the repository manager.

Open or clone a repository

Use File → Open… to open an existing local repository.

Use File → Clone Repository… or press ⌃⌘C to clone a repository. You can also open Repository → Quick Action with ⌘P; Quick Actions understand clone URLs when you paste or type one into the palette.

Add accounts and credentials

Open Gitfox → Settings → Accounts & Credentials to add GitHub, GitLab, GitLab Self-Managed, Bitbucket, or Gitea accounts. These accounts are used for HTTPS authentication and hosted-service repository actions.

SSH remotes use your normal SSH configuration instead.

Configure Git identity

Open Gitfox → Settings → Git to edit your global user.name, user.email, default branch, and Git binary selection.

Open Gitfox → Settings → Identities or Identities & Signing to add app-level identities that can be selected when committing.

Make your first commit

Open the worktree view, stage files or selected changes, then use Worktree → Commit or press C. The commit window supports recent messages, merge messages, identities, sign-off, amend, commit hooks, and commit signing where the app variant supports it.