ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Undo​Tree

by huyhoang8398 ALL

The undo history visualizer for Sublime Text

Labels undo, utilities

Details

Installs

  • Total 63
  • Win 31
  • Mac 18
  • Linux 14
Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8 Sep 7 Sep 6 Sep 5 Sep 4 Sep 3 Sep 2 Sep 1 Aug 31 Aug 30 Aug 29 Aug 28
Windows 0 0 0 1 0 0 0 1 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0
Mac 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 1
Linux 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1

Readme

Source
raw.​githubusercontent.​com

UndoTree for Sublime Text

Package Control Sublime Text

A Vim-style UndoTree plugin for Sublime Text 4 (Python 3.8+), visualizing undo history as a branching ASCII tree with live diff previews.

Features

  • Branching undo history — every save creates a new node; multiple branches supported
  • ASCII tree visualization — shows the hierarchy of undo states using indentation and -
  • Current node marker — the active undo state is marked with *
  • Sequential counters — each node is numbered for easier reference (1 -> +2 -0)
  • Live diff preview — highlights changes when navigating the tree
  • Restore any state — select a node to restore its content in the editor
  • Automatic initial snapshot — captures file content on open
  • Lightweight & Python-only — no external dependencies

Installation

  1. Place the plugin folder into your Sublime Text Packages directory:
  • Linux: ~/.config/sublime-text/Packages/
  • Windows: %APPDATA%\Sublime Text\Packages\
  • macOS: ~/Library/Application Support/Sublime Text/Packages/
  1. Restart Sublime Text.

Usage

Open UndoTree

  • Open the command palette (Ctrl+Shift+P / Cmd+Shift+P) → Show UndoTree
  • The tree will appear in a Quick Panel, for example:
*1 -> Initial state
2 -> +2 -0
3 -> +1 -0
4 -> +3 -1
5 -> +1 -2
  • * marks the current node
  • -> separates the counter from the diff summary

Restore a Node

  • Move the selection in the Quick Panel
  • Press Enter → restores the editor content to that node
  • Hovering over nodes shows a live diff preview in a separate panel

UndoTree Behavior

  • Every file save creates a new node
  • Branches are automatically tracked if you modify the file from an older state
  • Initial file load automatically captures the starting state

Example Tree

*1 -> Initial state
2 -> +2 -0
3 -> +1 -0
4 -> +3 -1
5 -> +1 -2
  • Shows indentation for branches
  • Current node is marked with *
  • Numbers help track node order

Commands

Command Description
show_undo_tree Opens the UndoTree Quick Panel
undo_tree_restore Restore buffer content to a specific node
undotree_write_preview Internal: writes live diff preview
undotree_write_panel Internal: updates ASCII tree panel

Requirements

  • Sublime Text 4 / 3.8+
  • Python 3.8+ (built-in with Sublime Text 4)
  • No additional dependencies

Notes

  • ASCII tree uses spaces and - only for branch visualization, so it works in any font
  • Hover preview works with the diff panel
  • Branches can be navigated visually, but the Quick Panel does not allow full Vim-style j/k navigation yet