Magit is an interface to Git for Emacs.
Unlike Emacs's native version control support which strives to provide a unified interface to various version control systems, Magit only supports Git and can therefor take full advantage of its native features.
Magit supports GNU Emacs 22.1 or later; 24.1 or later is recommended.
To get started with Magit, run M-x magit-status. If you
are inside a Git repository this opens a buffer that summarizes its
status. Otherwise you are first prompted for a repository. Read the
short help for magit-mode
(C-h m in the status buffer),
make some changes to your files, then stage (s) and commit
(c) them.
For more details consult the Magit user manual. You can read it on the web or in Emacs with C-u C-h i magit.info.
Magit also has a website.
Emacs >=24.1 includes a facility that lets you easily download and
install packages. Using package.el
is the easiest and recommended
way to install Magit and its dependencies. If you don't want to use
it see the extended installation instructions in INSTALL.md
(weblink).
The stable Magit version is available from the Marmalade
package repository. If you want to install the development version
(the master
branch) use the Melpa repository instead.
Please note that all packages on Melpa are built from the upstream
master
branch. If you generally want stable versions but the latest
Magit use Marmalade and install Magit from Git.
First tell package.el
to use one of the package repositories:
(add-to-list 'package-archives
'("melpa" . "http://melpa.milkbox.net/packages/") t)
or
(add-to-list 'package-archives
'("marmalade" . "http://marmalade-repo.org/packages/") t)
For details please see the website of the package repository of your choosing.
Then install Magit (and its run-time dependencies):
M-x package-install RET magit RET
Magit's canonical source repository is hosted on Github.
Magit was started by Marius Vollmer and is now collectively maintained by the Magit Owners Team. Many more people have contributed.
To report bugs and make feature requests please use the issue tracker and Github pull requests. You may also use Magit's Google group. Before making a pull request please read CONTRIBUTING.md (weblink).