It's Magit! An Emacs mode for Git
The Magit wiki contains a list of FREQUENTLY ASKED QUESTIONS, please do consult it.
Magit is in FEATURE FREEZE, please keep that in mind when making feature requests.
Unlike the VC package which is part of Emacs and strives to provide a unified interface to various version control systems, Magit only supports Git and can therefore better take advantage of its native features.
Magit supports GNU Emacs 23.2 or later; 24.1 or later is recommended. Magit supports Git 22.214.171.124 or later; 1.8.2 or later is recommended. The minimal versions are those available in Debian oldstable.
Table of Contents
- Getting Started
- Getting Help
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-status-mode (C-h m in the status
Then edit and save some files, refresh the status buffer (g), stage changes (s) and commit (c) them.
For more details consult the Magit user manual. You can read it with C-u C-h i magit.info or on the web.
We can also recommend this introduction from the Mastering Emacs blog. It even describes some new features that are not yet documented in the manual.
Magit also has a website.
Magit is hosted on Github. Please contribute by suggesting features on the issue tracker or by making code contributions using pull requests. Before opening a pull request make sure to read the brief guidelines.
Please also consider supporting development using gratipay. Thank you!
Magit was started by Marius Vollmer and is now maintained by Jonas Bernoulli. Other Magitians (former maintainers) are Nicolas Dudebout, Peter J. Weisberg, Phil Jackson, Rémi Vanicat, and Yann Hodique.
Many more people have contributed code and suggested features.
Thanks to all of you, may (the history of) the source be with you!
Beginning with version 24.1 Emacs includes a package management
facility known as Elpa or
package.el. Using an Elpa package
repository is the easiest and recommended way to install and update
Magit and its dependencies. Among other things using
is recommended because that automatically takes care of installing
Also see Which version should I install?
Installing from Melpa
If you have already used Melpa to install some other package then all you have to do is:
M-x package-install RET magit RET
This installs Magit as well as all of its dependencies and makes them available in the current and future Emacs sessions.
If this is the first time you are using Melpa, then you have to
(require 'package) (add-to-list 'package-archives '("melpa" . "http://melpa.org/packages/") t)
Then evaluate these forms, update the package cache, and install Magit as above. To update the cache use:
M-x package-refresh-contents RET
You might also want to have a look at the more detailed
instructions provided by the Melpa project. Among
other things it explains how to install only some packages from Melpa
and others from Marmalade, and how to use
package.el with older
versions of Emacs.
Installing from Git
If you want to contribute to Magit you should run it directly from the Git repository.
First get the repository:
$ git clone git://github.com/magit/magit.git
Then you should byte compile the libraries and generate the documentation, though that is not required:
$ make lisp docs
Unless all dependencies are installed at
../DEPENDENCY you have to
make where to find them, e.g.:
$ EFLAGS="-L /path/to/git-modes" make lisp docs
Then add this to you init file:
(add-to-list 'load-path "/path/to/git-modes") (add-to-list 'load-path "/path/to/magit") (eval-after-load 'info '(progn (info-initialize) (add-to-list 'Info-directory-list "/path/to/magit/"))) (require 'magit)
If you are using an Emacs version before 24.3, then you also have to
cl-lib and tell
make as well as Emacs where to find it.
To view available make targets use:
$ make help
To update use:
$ git pull $ make lisp docs
Before creating a pull request always run:
$ make lisp test
You may also build Magit manually:
$ emacs -Q --batch -L . -L /path/to/DEPENCENCY -f batch-byte-compile *.el $ makeinfo -o magit.info magit.texi $ install-info --dir=dir magit.info
If you install Magit using
package.el then dependencies are
automatically being taken care of. Otherwise you have to track down
dependencies and install them manually.
cl-libis a new library in Emacs 24.3. Like the old
clit provides various Common Lisp forms, but differs in that symbols are prefixed with
cl-. A forward compatibility
cl-libfor older versions of Emacs is available from the GNU Elpa repository. You can install it using
package.elor get it here.
git-commit-modewhich is part of the git-modes repository and available as a separate package from Melpa.
git-rebase-modewhich is part of the git-modes repository and available as a separate package from Melpa.
The following libraries build on third-party tools or git subcommands that are not installed by the Git base-package on some distributions:
magit-svn.elrequires the official Git subcommand
Dependencies of Tests
To run tests the following libraries are also required:
ertis a tool for automated testing. It is part of Emacs starting with version 24.1. You can also obtain an old version from the former development repository.