Help, whenever you need it
The steps to get going, what gitā needs on your Mac, and answers to the questions that come up. Anything else: the project's issue tracker.
Up and running
- 1
Get gitā
Download the ZIP of the latest release from GitHub and drag gitā to your Applications folder. It is free.
- 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
Open a repository
Open gitā and choose a repository on your Mac, or clone one. The history opens with every branch in one graph.
Help topics
The two pages people need most.
Troubleshooting
The messages and situations that come up, and what to do about each.
gitā says it cannot find git
xcode-select --install in Terminal, let it finish, and open gitā again.The GitHub pages are empty or say gh is not signed in
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
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
Notifications never arrive
A repository opens slowly
My other GitHub account is used
Questions, answered
Is gitā free?
Where do I report a bug?
How do I get updates?
What does gitā need on my Mac?
git, gh and vercel command-line tools with their existing sign-ins. The details are on the compatibility page.Where is my data stored?
In which languages is gitā available?
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.