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.
Download the latest tarball from the github download page, then Magit can be installed with the popular recipe of:
$ make && sudo make install
This requires emacs
and makeinfo
binaries, so please make sure the relevant
packages (generally emacs
and texinfo
) are installed on your system.
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:
(require 'magit-svn)
- integrates with git-svn. Hit 'N' to see your
options.
(require 'magit-topgit)
- integrates with topgit.
(require 'magit-stgit)
- integrates with StGit.
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.
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.
Magit was started by Marius Vollmer. It is now collectively maintained by the Magit Owners Team: https://github.com/organizations/magit/teams/53130
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.