Skip to content

Main Navigation

Home
(emacs)
- *Info*
  (intro)
  (manual)
- *Help*
  (describe-function)
  (describe-variable)
  (describe-face)

Appearance

Sidebar Navigation

Top

Introduction

Installation

Installing from Melpa
Installing from the Git Repository
Post-Installation Tasks

Getting Started

Interface Concepts

Modes and Buffers
- Switching Buffers
  Naming Buffers
  Quitting Windows
  Automatic Refreshing of Magit Buffers
  Automatic Saving of File-Visiting Buffers
  Automatic Reverting of File-Visiting Buffers
Sections
- Section Movement
  Section Visibility
  Section Hooks
  Section Types and Values
  Section Options
Transient Commands
Transient Arguments and Buffer Variables
Completion, Confirmation and the Selection
- Action Confirmation
  Completion and Confirmation
  The Selection
  The hunk-internal region
  Support for Completion Frameworks
  Additional Completion Options
Mouse Support
Running Git
- Viewing Git Output
  Git Process Status
  Running Git Manually
  Git Executable
  Global Git Arguments
  Mapping Git Hooks to Lisp Hooks

Inspecting

Status Buffer
- Status Sections
  Status File List Sections
  Status Log Sections
  Status Header Sections
  Status Module Sections
  Status Options
Repository List
Logging
- Refreshing Logs
  Log Buffer
  Log Margin
  Select from Log
  Reflog
  Cherries
Diffing
- Refreshing Diffs
  Commands Available in Diffs
  Diff Options
  Revision Buffer
Ediffing
References Buffer
- References Sections
Bisecting
Visiting Files and Blobs
- General-Purpose Visit Commands
  Visiting Files and Blobs from a Diff
Blaming

Manipulating

Creating Repository
Cloning Repository
Staging and Unstaging
- Staging from File-Visiting Buffers
Applying
Committing
- Initiating a Commit
  Editing Commit Messages
Branching
- The Two Remotes
  Branch Commands
  Branch Git Variables
  Auxiliary Branch Commands
Merging
Resolving Conflicts
Rebasing
- Editing Rebase Sequences
  Information About In-Progress Rebase
Cherry Picking
- Reverting
Resetting
Stashing

Transferring

Remotes
- Remote Commands
  Remote Git Variables
Fetching
Pulling
Pushing
Plain Patches
Maildir Patches

Miscellaneous

Tagging
Notes
Submodules
- Listing Submodules
  Submodule Transient
Subtree
Worktree
Sparse checkouts
Bundle
Common Commands
Wip Modes
- Wip Graph
Commands for Buffers Visiting Files
Minor Mode for Buffers Visiting Blobs

Customizing

Per-Repository Configuration
Essential Settings
- Safety
  Performance
  Global Bindings

Plumbing

Calling Git
- Getting a Value from Git
  Calling Git for Effect
Section Plumbing
- Creating Sections
  Section Selection
  Matching Sections
Refreshing Buffers
Conventions
- Theming Faces

FAQ

FAQ - How to …?
- How to pronounce Magit?
  How to show git’s output?
  How to install the gitman info manual?
  How to show diffs for gpg-encrypted files?
  How does branching and pushing work?
  Should I disable VC?
  The diff/log is filtered to one file; how do I show all changes.
FAQ - Issues and Errors
- Magit is slow
  I changed several thousand files at once and now Magit is unusable
  I am having problems committing
  I am using MS Windows and cannot push with Magit
  I am using macOS and SOMETHING works in shell, but not in Magit
  Expanding a file to show the diff causes it to disappear
  Point is wrong in the COMMIT_EDITMSG buffer
  The mode-line information isn’t always up-to-date
  A branch and tag sharing the same name breaks SOMETHING
  My Git hooks work on the command-line but not inside Magit
  git-commit-mode isn’t used when committing from the command-line
  Point ends up inside invisible text when jumping to a file-visiting buffer
  I am no longer able to save popup defaults

Debugging Tools

Keystroke Index

Function and Command Index

Variable Index

On this page

Installation

Magit can be installed using Emacs’ package manager or manually from its development repository.

Installing from Melpa
Installing from the Git Repository
Post-Installation Tasks

Pager

Previous pageIntroduction

Next pageInstalling from Melpa

Docs

Emacs
Elisp
Gallery
Elisp Docs

Sites

GNU
Org Mode
FSF

More

Other Manuals
Q & A
License(s)
Codeberg