How to install tabout.nvim with packer?

Add the plugin to your packer setup using the Lua configuration provided in the README, ensuring the setup function is called after dependencies like nvim-treesitter and nvim-cmp. Set options like tabkey and tabouts based on your preferences.

tabout.nvim vs auto-pairs – which is better for Neovim?

tabout.nvim focuses on tab-based navigation out of pairs for faster cursor movement, while auto-pairs typically handles automatic pair insertion and deletion. Choose tabout.nvim if you prioritize efficient exiting from symbols; auto-pairs if you want automated pair management with less setup.

Why isn't tabout.nvim working in my Python files?

This is likely because you lack the tree-sitter parser for Python. Install it using nvim-treesitter, as tabout.nvim requires tree-sitter for context detection in each language, as specified in the requirements section.

How to configure tabout.nvim to work with nvim-cmp?

Set the 'completion' option appropriately and use the fallback function in nvim-cmp mappings, as detailed in the README. This ensures Tab key prioritizes completion menu navigation before triggering tabout.

Can I use tabout.nvim with Vim instead of Neovim?

No, tabout.nvim is Neovim-specific and relies on features like the Lua API and tree-sitter integration. Vim users would need alternative plugins or consider switching to Neovim for this functionality.

How to add custom symbol pairs in tabout.nvim?

Add entries to the 'tabouts' configuration array, e.g., {open = ' '}. Note that only single-character pairs are supported currently, as mentioned in the options documentation.

Open-Awesome

tabout.nvim

UnlicenseLua

A Neovim plugin that lets you tab out of parentheses, quotes, and other paired symbols for faster editing.

GitHub

856 stars20 forks0 contributors

What is tabout.nvim?

tabout.nvim is a Neovim plugin that enhances editing efficiency by allowing users to press the Tab key to jump outside of paired characters like parentheses, quotes, and brackets. It solves the common annoyance of having to manually move the cursor after typing inside such symbols, integrating seamlessly with Neovim's ecosystem.

Target Audience

Neovim users who write code in languages with frequent paired symbols (e.g., JavaScript, Python, Lua) and want to optimize their editing speed and reduce keystrokes.

Value Proposition

Developers choose tabout.nvim for its smooth, context-aware navigation that works with tree-sitter and popular completion plugins, offering a highly configurable and lightweight alternative to manual cursor movements or less integrated solutions.

Overview

tabout plugin for neovim

Use Cases

Best For

Quickly exiting parentheses or braces after typing function arguments
Moving out of quotes when writing strings or JSX attributes
Navigating around brackets in array or object literals
Integrating Tab key behavior with nvim-cmp and LuaSnip workflows
Reducing repetitive arrow key usage during coding sessions
Customizing tabout behavior for non-standard symbol pairs (e.g., macros)

Not Ideal For

Neovim setups without tree-sitter parsers installed for target languages
Users who heavily customize Tab for snippet expansion without wanting complex keybinding configurations
Developers working with filetypes lacking available tree-sitter parsers

Pros & Cons

Pros

Intelligent Pair Navigation

Pressing Tab moves the cursor outside paired characters like quotes and parentheses, leveraging tree-sitter for precise context detection, as demonstrated in the examples table with smart jumps from inside symbols.

Bidirectional Movement

Supports both forward (Tab) and backward (Shift+Tab) navigation, enabling flexible editing flow around symbols without manual cursor adjustments.

High Customizability

Allows defining custom symbol pairs via the 'tabouts' configuration and fine-tuning behavior with settings like 'ignore_beginning' and 'act_as_tab' for different scenarios.

Seamless Plugin Integration

Designed to work alongside popular completion plugins like nvim-cmp and snippet engines like LuaSnip, with documented strategies for avoiding keybinding clashes.

Cons

Tree-sitter Dependency

Only functions with languages that have installed tree-sitter parsers, limiting usability for unsupported filetypes, as explicitly noted in the exceptions section of the README.

Complex Keybinding Conflicts

Integrating with completion plugins often requires manual configuration of keybindings using fallback functions, which can be error-prone and time-consuming, as shown in the 'more complex keybindings' examples.

Limited Pair Character Support

Custom pairs are restricted to single-character open and close symbols due to the 'tabouts' configuration limitation, preventing support for multi-character delimiters like HTML tags.

Frequently Asked Questions

Related Projects

leap.nvim

Neovim's answer to the mouse 🦘

Stars5,031

Forks51

Last commit21 days ago

flash.nvim

Navigate your code with search labels, enhanced character motions and Treesitter integration

Stars4,048

Forks75

Last commit6 months ago

lightspeed.nvim

deprecated in favor of leap.nvim

Stars1,557

Forks28

Last commit2 years ago

precognition.nvim

💭👀precognition.nvim - Precognition uses virtual text and gutter signs to show available motions.

Stars1,324

Forks16

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