Display your undo history in a graph.
Vim script
Pull request Compare This branch is 95 commits behind mbbill:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Link to Vim.org



Vim 7.0 added a new feature named Undo branches. Basically it's a kind of ability to go back to the text after any change, even if they were undone. Vim stores undo history in a tree which you can browse and manipulate through a bunch of commands. But that was not enough straightforward and a bit hard to use. You may use :help new-undo-branches or :help undo-tree to get more detailed help. Now this plug-in will free you from those commands and bring back the power of undo tree.


  1. Visualize undo-tree
    • The undo history is sorted based on the changes' timestamp. The year/month/day field will not be displayed if the changes were made within the same day.
    • The change sequence number is displayed before timestamp.
    • The current position is marked as >seq<.
    • The next change that will be restored by :redo or <ctrl-r> is marked as {seq}, it's the same as curhead returned by undotree()
    • The [seq] marks the last change and where further changes will be added, it's the same as newhead returned by undotree()
    • Saved changes are marked as s and the current change is S
  2. Live updated diff panel.
  3. Highlight changed text.
  4. Revert to a specific change by mouse click or enter key.
  5. Hotkey support.
  6. Display changes in diff panel.



  1. Unpack all scripts into plugin directory and that's all. This script is written purely in Vim script with no additional dependency.


  1. Use :UndotreeToggle to toggle the undo-tree panel. You may want to map this command to whatever hotkey by adding the following line to your vimrc, take F5 for example.

    nnoremap <F5> :UndotreeToggle<cr>

  2. Then you can try to do some modification, and the undo tree will automatically updated afterwards.

  3. There are a bunch of hotkeys provided by vim to switch between the changes in history, like u, <ctrl-r>, g+, g- as well as the :earlier and :later commands.

  4. You may also switch to undotree panel and use the hotkeys to switch between history versions. Press ? in undotree window for quick help of hotkeys.

  5. You can monitor the changed text in diff panel which is automatically updated with undotree panel.

  6. Persistent undo

    • It is highly recommend to enable the persistent undo. If you don't like your working directory be messed up with the undo file everywhere.

Add the following line to your vimrc in order to make them stored together.

if has("persistent_undo")
    set undodir = '/path/to/what/you/want/'
    set undofile


  1. Basically, you do not need any configuration to let it work, cool?
  2. But if you still want to do some customization, there is also a couple of options provided.
    • Here is a list of these options.

Post any issue and feature request here:



  1. Create a file under $HOME with the name undotree_debug.log
    • $touch ~/undotree_debug.log
  2. Run vim, and the log will automatically be appended to the file, and you may watch it using tail:
    • $tail -F ~/undotree_debug.log
  3. If you want to disable debug, just delete that file.


Someone asked me about the difference with Gundo, here is a list of differences, or advantages.

  1. Pure vimscript implementation and no 3rd-party libraries(like python) is needed, don't worry about performance, it's not such a big deal for vim to handle this. The only dependency is the 'diff' tool which always shipped with vim and even without 'diff' you still can use most of the features of this script.
  2. Realtime updated undo tree. Once you make changes, the undo tree will be updated simultaneously.
  3. Several useful marks, like current changeset, next redo changeset, saved changeset, etc.
  4. Toggle between relative timestamp and absolute timestamp.
  5. Realtime updated undo window.
  6. Ability to clear undo history.
  7. More customizable.




Ming Bai <mbbill AT gmail DOT COM>