layout | title | logo | home |
---|---|---|---|
default |
A Git Porcelain inside Emacs |
big |
true |
Magit is a complete text-based user interface to Git. It fills the
glaring gap between the Git command-line interface and various GUIs,
letting you perform trivial as well as elaborate version control tasks
with just a couple of mnemonic key presses. Magit looks like a
prettified version of what you get after running a few Git commands
but in Magit every bit of visible information is also actionable to an
extent that goes far beyond what any Git GUI provides and it takes
care of automatically refreshing this output when it becomes outdated.
In the background Magit just runs Git commands and if you wish you can
see what exactly is being run, making it possible for you to learn
the git
command-line by using Magit.
Using Magit for a while will make you a more effective version control user. Magit supports and streamlines the use of Git features that most users and developers of other Git clients apparently thought could not be reasonably mapped to a non-command-line interface. Magit is both faster and more intuitive than either the command line or any GUI and these holds for both Git beginners and experts alike.
If you are new to Magit, then either one of the following two articles should help understanding how it differs from other Git clients. Click the triangles to expand brief summaries.
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.
Or you might prefer a video introduction.
<script type="text/javascript" src="/quotes/quotes.js"></script> <script type="text/javascript">window.onload = function(){inject_quotes(); simpleCssSwitch();}</script>
- 2021-10-14 — Forge v0.4.0 and v0.4.1 released (announcement)
- 2024-08-09 — Magit v4.0.0 released (announcement)
- 2023-11-28 — Transient v0.5.0 released (announcement)
- 2023-05-10 — Transient v0.4.0 released (announcement)
- 2021-10-14 — Forge v0.3.0 released (announcement)
- 2021-10-04 — Magit v3.3.0 released (announcement)
- 2021-08-06 — Magit available from NonGNU Elpa (announcement)
- 2021-08-01 — Magit v3.2.0 released (announcement)
- 2021-07-01 — Magit v3.1.0 released (announcement)
- 2021-04-25 — Forge v0.2.0 released (announcement)
- 2021-05-25 — Magit v3.0.0 released (announcement)
- 2021-02-21 — Transient v0.3.0 released (announcement)
- 2020-02-26 — Transient v0.2.0 released (announcement)
- 2020-01-23 — Magit-Section as a stand-alone package (announcement)
- 2019-02-14 — Transient v0.1.0 released (announcement)
- 2018-12-19 — Forge v0.1.0 released (announcement)
- All manuals (for releases)
- Magit User Manual (single-page, pdf, epub)
- Forge User Manual (single-page, pdf)
- Ghub User and Developer Manual (single-page, pdf)
- Magit-Section Developer Manual (single page, pdf)
- Transient User and Developer Manual (single-page, pdf)
- With-Editor User Manual (single-page, pdf)
- Magit Reference Card
- [Wiki][wiki]
- Development
- Support
- [Announcements on Mastodon][mastodon]
- Screenshots
- Screencasts
- User quotes
- Blog posts
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, the Emacs Subreddit or Github discussions.
Please do NOT use the GitHub issue tracker for support requests. We only use it for feature requests and bug reports.
Magit was started by Marius Vollmer, and is now maintained by Jonas Bernoulli, Kyle Meyer, and Noam Postavsky. 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 backers of the 2017 crowdfunding campaign.
[//]: # https://gitter.im/magit/magit [//]: # https://groups.google.com/forum/?fromgroups#!forum/magit [//]: # https://twitter.com/magit_emacs [mastodon]: https://mastodon.social/@tarsius [wiki]: https://github.com/magit/magit/wiki