/magit

Part of my Emacs config, may contain code not in upstream

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

A Git Porcelain inside Emacs

homepage | manual | faq | wiki | mailing list | forum | news


Magit is an interface to the version control system Git, implemented as an Emacs package. Magit aspires to be a complete Git porcelain. While we cannot (yet) claim that Magit wraps and improves upon each and every Git command, it is complete enough to allow even experienced Git users to perform almost all of their daily version control tasks directly from within Emacs. While many fine Git clients exist, only Magit and Git itself deserve to be called porcelains.


Keeping its users this excited is a lot of work . If Magit makes you
more productive too, then please consider making a donation.
Thank you! — Jonas Bernoulli

Donate using Github Sponsors    Donate using IBAN    Donate using Zelle (USA bank transfer)    Donate using PayPal

Some alternative donation methods are available.

Getting Started

If you are new to Magit, then either one of the following two articles should help understanding how it differs from other Git clients.

  • Visual Magit walk-through

    If you are completely new to Magit, then this article is a good visual introduction.

    Almost everything that you see in Magit can be acted on by pressing some key, but that's not obvious from just seeing how Magit looks. The screenshots and accompanying text of this article explain how to perform a variety of actions on Magit's output.

  • Magit, the magical Git interface

    Magit differs significantly from other Git interfaces, and its advantages are not immediately obvious simply from looking at a few screenshots as presented in the preceding article.

    This article discusses Magit's properties in somewhat more abstract terms.

Support

When something doesn't work as expected then please first see the FAQ. Then also try the list of open issues and use the search box at the top of that page to find older related issues. You should also consult the manual and ask a general-purpose search engine.

If that doesn't answer your question, then ask for help on the Emacs Stackexchange site or the mailing list. We only use the GitHub issue tracker for feature requests and bug reports, so please don't ask for help there.

Contributing

To report bugs and suggest new feature use the issue tracker. If you have some code which you would like to be merged, then open a pull request. Please also see CONTRIBUTING.md.

Acknowledgments

Magit was started by Marius Vollmer, and is now maintained by Jonas Bernoulli, Kyle Meyer, and Noam Postavsky. Other 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.

Over the years a lot of people supported development financially, including the 1987 backers of the 2017 crowdfunding campaign.

Thanks to all of you, may (the history of) the source be with you!


Paren Xkcb GPL v3 Build Status Melpa Melpa Stable Git Xkcd Eierlegende Wollmilchsau Swiss Made Netscape