SourceTree a Free Git and Mercurial GUI (Mac OSX)

Atlassian SourceTree is a GUI client you can use to quickly and easily view the status of Git, Mercurial, and Subversion source repositories. SourceTree provides special support for hosted DVCS systems such as Bitbucket Cloud and GitHub. Using a single SourceTree client, you can work with local repositories and hosted repositories in multiple source control systems. Why not install SourceTree and give it a try to see if it is a fit for you?

Adding a hosted project in SourceTree

If you haven't already, start SourceTree. Then, do the following:

  1. Choose View > Show Hosted Projects from the menu bar.
    The system displays the Hosted Repositories dialog.
  2. Press Edit Accounts.
    The system displays a list of the hosted accounts it knows about. If this is the first time you have run this, the list is empty.
  3. Press Add Account.
  4. Complete the dialog:

    The Username is your account name. The password you provide is your account password. You can choose whether you prefer connecting through HTTPS or SSH.
  5. Press OK.
    SourceTree returns you to the list of hosted accounts. You can add another if you like.
  6. Press Close when you are done adding accounts.
    The system displays a list of your hosted repositories and repositories your account is following.
  7. Press Close.

You'll notice that the SourceTree does not list your hosted repositories on your Bookmarks list. The bookmarks list is only for local repositories; you'll need to clone from a hosted repository or create a local repository to add to this list.

Clone a hosted project

To clone a hosted project to your local machine, you can do the following:

  1. Press Hosted Projects.

    The system displays your hosted projects.
  2. Select a project on the list.
  3. Right-click to show the context menu.
  4. Click Clone.
    The system adds the clone to your list of bookmarks.

Doing more with SourceTree

There is a lot more you can do with SourceTree as you can see with this repository viewer:

To learn more, try SourceTree yourself or review the Help that comes with it.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

10 Archived comments

  1. User avatar

    Azeem Shaikh

    Is there any comparable GUI tool for Windows users?

    19 Dec 2012
    1. User avatar

      Kelly Schoenhofen

      TortoiseGit is the closest tool for Windows users, IMO.

      19 Dec 2012
      1. User avatar


        SourceTree is now available for Windows!! (smile)

        16 May 2013
  2. User avatar


    I prefer Gitbox. Any chance of adding one click support?

    02 Jan 2013
    1. User avatar


      The best chance of getting this is to file an enhancement request.

      02 Jan 2013
  3. User avatar


    Tried following this tutorial, but really didn't want to install or learn how to use the command-line Git tools on my Mac when I could be using SourceTree...  Is there a tutorial in the works that goes into the same depth as this tutorial but focuses on using SourceTree with Bitbucket?

    15 Nov 2013
    1. User avatar


      Sorry no. You can add your voice to this post on Answers.

      15 Nov 2013
  4. User avatar


    Any chance of ever producing a Linux client?

    27 Dec 2013
  5. User avatar

    Michael Reeves

    This material appears dated.  The GUI no longer matches the instructions.

    27 Apr 2015
    1. User avatar

      Dan Stevens [Atlassian]

      Hey Michael,

      Yes, unfortunately this page is out of date. We're working a new tutorials which are more descriptive and introduce SourceTree better. In the mean time I'll update this page with a note and if I can some new screen shots. 

      Thanks for taking the time to comment.

      Happy coding,


      27 Apr 2015
Powered by Confluence and Scroll Viewport