/magit

It's Magit! An Emacs mode for Git.

Primary LanguageEmacs LispGNU General Public License v3.0GPL-3.0

It's Magit! An Emacs mode for Git.

Magit is an interface to Git for Emacs, supporting GNU Emacs 22 or later.

Unlike Emacs's native version control support, Magit can take advantage of Git's native features without breaking compatibility with other systems.

To get started see the Magit User Manual or perhaps the cheatsheet if you're in a hurry. There's also an excellent Magit screencast by Alex Vollmer which demonstrates some of the major features.

Installing

Download the latest tarball from the github download page, then Magit can be installed with the popular recipe of:

make && sudo make install

This will put magit.el into /usr/local/share/emacs/site-lisp, where Emacs should be able to find it. Then add

(require 'magit)

to your .emacs file.

Magit also now supports extensions:

git-svn

(require 'magit-svn) - integrates with git-svn. Hit 'N' to see your options.

git-topgit

(require 'magit-topgit) - integrates with topgit.

git-stgit

(require 'magit-stgit) - integrates with StGit.

Getting started

To get started with Magit, open any file in a Git repository in Emacs and run M-x magit-status. Read the short help for magit-mode (C-h m in the Magit buffer), make some changes to your files, and try to commit them.

Learning more

The Magit User Manual describes things with more words than the online help. You can read it in Emacs with C-u C-h i magit.info, or on the web.

If you have any questions, please use the mailing list at Google Groups.

Magit's website is currently hosted on GitHub.

Development

Magit was started by Marius Vollmer. Phil Jackson is the lead developer. For a full list of contributors have a look at magit.el in the source distribution.

Magit's canonical source repository is currently hosted on GitHub.