İçeriğe geç

Up and running

  1. 1

    Get gitā

    Download the ZIP of the latest release from GitHub and drag gitā to your Applications folder. It is free.

  2. 2

    Have the tools it runs

    gitā works through the git, gh and vercel command-line tools. git comes with the Mac's Command Line Tools; sign in to gh and vercel and gitā can use them right away.

  3. 3

    Open a repository

    Open gitā and choose a repository on your Mac, or clone one. The history opens with every branch in one graph.

Troubleshooting

The messages and situations that come up, and what to do about each.

gitā says it cannot find git
git is not installed, or the Command Line Tools are missing. Run xcode-select --install in Terminal, let it finish, and open gitā again.
The GitHub pages are empty or say gh is not signed in
gitā reads GitHub through the gh command. Run gh auth status in Terminal to see the sign-in, and gh auth login to sign in. If gh is signed in to more than one account, gitā uses one that can see the repository; you can pick the account yourself.
Vercel deployments do not appear
Deployments come through the vercel command-line tool. Check it is installed and signed in (vercel whoami), and that the repository is linked to its Vercel project.
A coding agent is missing from the Worktrees & Agents pane
gitā recognises Claude Code, Codex, Gemini CLI, Cursor Agent, opencode and Aider. Make sure the agent is running on your Mac. For Claude Code and Codex, the hooks in Settings ▸ AI Agents report the moment an agent asks a question or finishes.
Notifications never arrive
Notifications are off until you allow them. Turn the kinds you want on in Settings ▸ Notifications, and check that macOS allows notifications for gitā in System Settings ▸ Notifications.
A repository opens slowly
Turn on the setting in Settings ▸ History that writes git's commit-graph file and keeps the index fresh for repositories that are slow to read. Your commits and files are not changed.
My other GitHub account is used
If gh is signed in to more than one account, gitā picks one that can see the repository and remembers it. You can also pick the account yourself.

Questions, answered

Is gitā free?
Yes. gitā is free, with no account and nothing to unlock. The source and every release are on GitHub.
Where do I report a bug?
In the project's issue tracker, with your macOS version, what you did and what happened.
How do I get updates?
New versions appear on the project's GitHub releases. Download the latest one and replace the app in your Applications folder.
What does gitā need on my Mac?
macOS 14 or later, on Apple silicon and Intel. It works through the git, gh and vercel command-line tools with their existing sign-ins. The details are on the compatibility page.
Where is my data stored?
On your Mac. gitā has no account, no analytics and no server of its own. What it stores, and where, is in the privacy policy.
In which languages is gitā available?
The app and this site are in 18 languages, and gitā has nine themes in light and dark.

Still stuck? Tell us

Open an issue on the project's GitHub tracker with your macOS version, what you did, what you expected and what happened. Every issue gets read.

  • Your macOS version (About This Mac).
  • What you did, and what you expected to happen.
  • What happened instead, with the message if there was one.
  • The repository, if it is public.

Please never send passwords, secret keys or access tokens.