How to install atone.nvim with lazy.nvim?

Add the plugin to your lazy.nvim config with the provided Lua snippet, specifying cmd as 'Atone' and opts for customization. Ensure you follow the installation example in the README for proper setup.

atone.nvim vs built-in undotree: which is better?

atone.nvim is better for advanced features like TreeSitter diff and marks, but requires plugin setup. Built-in undotree is sufficient for basic undo navigation with no configuration, as compared in the README table.

How to customize node labels in atone.nvim?

Enable custom labels by setting `ui.node_label.custom = true` and providing a formatter function that uses fields like seq and h_time. Examples in the README show how to return plain strings or highlighted chunks.

Does atone.nvim save marks between Neovim sessions?

Yes, marks can be persisted by enabling `marks.persist` and specifying a path, defaulting to a JSON file in Neovim's data directory. This allows marks to survive editor restarts as documented.

What keybindings does atone.nvim use by default?

Default keybindings include j/k for node navigation, to undo to a node, m to set marks, and q to quit. All keymaps are listed in the configuration section and can be overridden.

How to disable auto-attach in atone.nvim?

Set `auto_attach.enabled = false` in the setup options. This stops the undo tree from automatically following buffer switches, giving manual control over which buffers are attached.

Open-Awesome

atone.nvim

GPL-3.0Lua

A modern, highly customizable undo tree plugin for Neovim with live syntax-aware diff previews.

GitHub

184 stars12 forks0 contributors

What is atone.nvim?

atone.nvim is a modern undo tree plugin for Neovim that visualizes your edit history as an interactive graph. It solves the problem of navigating complex undo histories by providing a clear, visual representation with advanced features like live diff previews and bookmarking.

Target Audience

Neovim users who frequently work with complex editing sessions and want enhanced undo navigation beyond the built-in capabilities.

Value Proposition

Developers choose atone.nvim for its modern UI, live syntax-aware diff previews, and high customizability, offering a significantly more powerful and visual undo experience compared to Neovim's basic undotree.

Overview

Modern undotree plugin for nvim

Use Cases

Best For

Visualizing complex edit histories in Neovim
Comparing changes between undo states with syntax highlighting
Bookmarking important points in undo history for quick return
Enhancing undo navigation in large codebases
Customizing undo tree appearance and behavior
Integrating TreeSitter-powered diff previews into editing workflow

Not Ideal For

Users satisfied with Neovim's built-in `:undotree` who want zero setup and minimal plugin footprint
Environments where TreeSitter is disabled or unavailable, as key diff features depend on it
Projects requiring undo management across specific buffer types excluded by auto-attach (e.g., non-empty buftype buffers)
Developers who prioritize absolute performance and avoid any visualization overhead, even if optimized

Pros & Cons

Pros

Live Syntax-Aware Diff

Uses TreeSitter for word-level inline highlighting in diff previews, providing instant, accurate change visualization as highlighted in the features list.

Auto-Attaching Tree

Automatically follows buffer switches, ensuring the undo tree is always relevant to the current editing context without manual intervention, as specified in the auto_attach configuration.

Node Marks and Navigation

Allows bookmarking undo states with persistent, named marks and integrates with fuzzy finders like Telescope for quick navigation, enhancing workflow efficiency.

High Customizability

Nearly every aspect, from layout to label formatting, is configurable via a detailed Lua setup, evidenced by the extensive configuration options and custom formatter examples.

Cons

Complex Configuration

The setup requires understanding Lua tables and numerous options, which can be overwhelming for users not deeply familiar with Neovim configuration, despite the documentation.

TreeSitter Dependency

Core features like syntax-aware diff previews rely on TreeSitter, so users without it enabled miss out on key functionality, limiting utility in some setups.

Potential Layout Instability

The README warns that non-adaptive diff window widths can cause 'unexpected edge-case bugs' in certain window layouts, indicating stability issues in specific scenarios.

Frequently Asked Questions

Related Projects

nvim-autopairs

autopairs for neovim written in lua

Stars4,066

Forks141

Last commit2 months ago

nvim-treesitter-context

Show code context

Stars3,215

Forks236

Last commit2 months ago

zen-mode.nvim

🧘 Distraction-free coding for Neovim

Stars2,149

Forks76

Last commit8 months ago

nvim-ts-autotag

Use treesitter to auto close and auto rename html tag

Stars2,104

Forks109

Last commit3 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub