Skip to content

Installing Git from GitHub for Mac

In today's release of GitHub for Mac, you can now easily install Git for use on the command line, without needing to download any separate packages. And whenever we update the version of Git included with GitHub for Mac, you'll get the changes automatically – no work required on your part!

After updating the app, you may notice some changes to the Preferences window. On the newly renamed "Advanced" tab, simply click "Install Command Line Tools":

Advanced preferences pane

You'll be prompted for an administrator password so that Git can be installed into /usr/local/bin, and then you should very shortly see that it succeeded:

Installation Complete

If you're using GitHub for Mac for the first time, and want to install Git, you can also set it up from the welcome screen:

Configure Git welcome screen

Once installed, you can open up and run git commands to your heart's content. Command line aficionados, rejoice!

Update: We've since removed the ability to install Git from GitHub for Mac, because OS X Mavericks and later includes a version of Git already.

Repository redirects are here!

It's a fact of life - sometimes repository names change. This can happen in a few different types of scenarios:

  • When you rename a repository.
  • When you rename your user or organization account.
  • When you transfer a repository from one user or organization to another.

We're happy to announce that starting today, we'll automatically redirect all requests for previous repository locations to their new home in these circumstances. There's nothing special you have to do. Just rename away and we'll take care of the rest.

As a special bonus, we'll also be servicing all Git clone, fetch, and push requests from previous repository locations.

There is one caveat with the new redirect support worth noting: GitHub Pages sites are not automatically redirected when their repositories are renamed at this time. Renaming a Pages repository will continue to break any existing links to content hosted on the domain or custom domains.

Personal API tokens

You can now create your own personal API tokens for use in scripts and on the command line. Be careful, these tokens are like passwords so you should guard them carefully. The advantage to using a token over putting your password into a script is that a token can be revoked, and you can generate lots of them. Head on over to your settings to manage personal API tokens.

screens shot

Wait! There are already some tokens in there!

Don't panic. You've always been able to create arbitrary OAuth access tokens via the API. In fact, if you use tools like hub or boxen they already make use of the authorizations endpoint to generate tokens instead of storing your password.

Closing Issues via Pull Requests

It's been possible to close an issue from a commit for quite a while, but some issues take more work than a single commit to close. That's why you can now close an issue from a Pull Request. All you have to do is include the special keyword syntax (eg. "fixes #5") in the body of your Pull Request.

And the referenced issue will automatically be closed when the PR is merged into the default branch.

You will even see the references as pending fixes before merging.

This works the same way closing an issue from a commit message does. It even works across repositories.

Happy bug fixing!

Jekyll Turns 1.0

GitHub Pages — the easiest way to quickly publish beautiful pages for you and your projects — just got a major upgrade. We're now running Jekyll 1.0.2, which contains over 100 changes and new features. Some of the ones we're most excited to start using:

  • Support for the Gist tag for easily embedding Gists (example)
  • Automatically generated post excerpts (example)
  • Save and preview drafts before publishing (example)
  • Lots of features that make creating and testing sites locally easier

You can read the full changelog to see exactly what's new, and if you generally run Jekyll on your computer, we'd recommend you also check out the information on upgrading.

New to Jekyll? This release also marks the launch of a brand new documentation site designed to help new users dive right in.

Jekyll's come a long way since it started nearly five years ago, and this milestone marks the open source project's first major release. Congratulations to all of the project's contributors. 🎉

File CRUD and repository statistics now available in the API

Today we're happy to announce two big additions to our API: File CRUD and Repository Statistics.


The repository contents API has allowed reading files for a while. Now you can easily commit changes to single files, just like you can in the web UI.

Starting today, these methods are available to you:

Repository Statistics

We're using the repository statistics API to power our graphs, but we can't wait to see what others do with this information.

Starting today, these resources are available to you:


Repository Search on all Repositories

Today we are allowing you to search your own public repositories and any private repositories you have access to.

In an effort to simplify our search, we've consolidated our search boxes into one. There's no need to look around anymore for the search box: it's always at the top.

When you're on a repository page, you'll see an indication that you're searching that repository by default:


To search globally, all you need to do is select the All repositories option:


You may have already noticed that the command bar will also give you these options:


Finally, if you didn't find what you were looking for in your repository, you can turn a repository search into a global search by clicking Search all of GitHub.


For any search related questions, take a look at a our search guides.

Good luck, gumshoes!

Check the status of your branches

Beginning today, you can head over to your favorite repository's Branches page and see the build status for the HEAD of each branch.

Better yet, the page updates automatically whenever a new build finishes. Enjoy!


Get up to speed with Pulse

Today we're happy to release Pulse. Pulse is a great way to discover recent activity on projects. Maybe you haven't checked on your favorite repository in a while or you just discovered a project that looks interesting to you. Pulse will show you who has been actively committing and what has changed in a project's default branch.

Pulse is also a great way to see new and merged pull requests, open and closed issues, and unresolved discussions.

You can find the link to the left of the nav bar.


New GitHub Logo

Today we are excited to ship a new iteration of our visual identity: an updated logo, an official mark, and an Octocat that conveys as much character as the Octocats that power GitHub (they push the buttons for us).

The Logotype


The Mark


The Octocat


The future

We've worked hard to preserve the things that both we and the community love about the GitHub identity while improving the things we felt didn't fit. We have big dreams and now an identity that will suit them well. If you would like copies of these assets to represent GitHub in your own apps check out the logos page for downloads and information about how and when they should be used.

Redesigned merge button

Merging branches on GitHub is already pretty awesome, and today it gets a little bit better with a redesigned merge button.

New merge button

In addition to being easier to read, the new merge button includes helpful instructions for checking out a branch and resolving any conflicts using Git on the command line.

Deleting branches after you merge has also been simplified. Instead of confirming the delete with an extra step, we immediately remove the branch when you delete it and provide a convenient link to restore the branch in the event you need it again.

Head over to your latest pull request and get merging to check it out.

Keep 🚢in'!

Enterprise Support in GitHub for Mac

Today, we're excited to 🚢 the latest release of GitHub for Mac with support for GitHub Enterprise. You'll now be able to use all of your favorite Mac features, such as "Clone in Mac", username autocompletion, and notifications, with your Enterprise repositories. We also support simultaneously logging in to, so you'll have all of your repositories available in one place.

Adding your Enterprise account

The "Accounts" preference pane has a new section:

Accounts preference pane

From here you can enter the URL and login details for your Enterprise server:

Enterprise login form

Once logged in, you'll see a new section in the sidebar that shows your Enterprise user and any organizations that you're a part of:

Enterprise server in the sidebar

As always, please get in touch if you have any questions, comments or suggestions.

Live long and prosper. ✌️

STL File Viewing

Here at GitHub, we're always excited to see people using GitHub to collaborate on all sorts of things, code or non-code. Today, we're adding a third dimension by making it easier to view some 3D models, specifically STL files, on GitHub.

Spinning Hand Model

You're able to spin the model by clicking & dragging, zoom in/out by scrolling, and change the view modes with the links at the bottom. This viewer is powered by Three.js and uses WebGL when available, but will fall back to the slower canvas renderer. If you have further questions, check out the help article.

There are a bunch of awesome 3D projects on GitHub, and more every day. We hope you enjoy a new way of viewing these complex files!

A smarter, more complete-y search bar


We often like to think of text as a UI at GitHub. We use text to navigate our text editors, we use keyboard shortcuts to delete our email, and we use application launchers to navigate our computers.

The command bar was one of our latest attempts at text as UI on GitHub, but it didn't quite feel right. So today we're launching a new redesigned search bar. Go ahead and give it a try.

Suggestions for you

If you're logged in, the search bar will give you suggestions for things you care about.


  • Users you follow
  • Repositories you've starred or contributed to
  • Issues you're watching across the site

Repository aware

If you're already browsing a repository, we'll tweak the suggestions to be repository aware. That means we'll autocomplete issues, pull requests, and files for just that repository.


Fewer commands, more completes

In order to do this we've had to strip out some of the less used commands previously supported in the command bar. You will no longer be able to follow/unfollow watch/unwatch from the command bar. We also removed some of the link jumping commands found in the my context and repository issues context.

Jump to anything with s and /

If you want to jump to the search bar immediately, use the hotkeys s or / and we'll autofocus the search field. We think it's an awesome way to jump to anywhere you want in GitHub.

Hope you enjoy!

Quickly access Repositories you contribute to

Starting today you'll see the list of "Repositories you contribute to" in the upper right-hand corner of your dashboard in addition to the list that already exists on your profile. We find it to be a great way to quickly access repositories in your Organizations and other repositories that you don't own, but contribute to.


Something went wrong with that request. Please try again.