arena.nvim
A frecency-based buffer switcher for Neovim that sorts files by frequency and recency for fast navigation.
What is arena.nvim?
arena.nvim is a Neovim plugin that provides a smart buffer switcher window. It uses a frecency algorithm to prioritize files based on how often and how recently they've been used, aiming to make buffer switching as fast as thought by reducing reliance on fuzzy finders and manual mark management.
Neovim users, particularly developers working on projects with many files who frequently switch between buffers and want a more intelligent, low-overhead navigation method.
Developers choose arena.nvim for its behavioral data-driven sorting that surfaces the most relevant buffers automatically, plus its dedicated window with built-in buffer management actions like pinning and deletion, reducing context switching compared to traditional fuzzy finders.
Overview
A smart (frecency-based) buffer switcher
Use Cases
Best For
- Neovim users who want a buffer switcher that learns from their usage patterns to prioritize frequently and recently accessed files.
- Developers tired of repeatedly using fuzzy finders for common file switches within a project.
- Users seeking to reduce manual maintenance of marks or bookmarks for frequently visited files.
- Teams or individuals working on large codebases who need quick navigation without memorizing file paths.
- Neovim plugin enthusiasts who prefer a configurable, dedicated window for buffer management with actions like splits, tabs, and buffer deletion.
- Developers who want per-project buffer filtering to keep their workspace focused on the current project's files.
Not Ideal For
- Users who rely heavily on fuzzy finders with advanced search and filtering capabilities for all navigation
- Neovim beginners uncomfortable with Lua configuration and plugin manager setup
- Projects where buffer switching is minimal or managed via sessions/workspaces without a dedicated window
- Teams needing out-of-the-box functionality with zero configuration; arena.nvim requires tuning frecency factors and window options
Pros & Cons
Pros
Uses a frecency algorithm that combines frequency and recency to rank buffers, automatically surfacing the most relevant files based on usage patterns without manual intervention.
Provides built-in actions like deleting buffers, pinning important files, and opening in splits or tabs directly from the window, reducing the need for separate commands or plugins.
Offers configurable window size, borders, and optional devicons (with nvim-web-devicons), allowing users to tailor the appearance to their workflow as shown in the README examples.
Supports per-project filtering to limit buffers to the current project, helping keep the workspace organized in multi-project environments, as highlighted in the configuration options.
Cons
Requires Lua setup and tuning of algorithm factors (e.g., recency_factor, frequency_factor), which can be complex for users new to Neovim configuration, and the README lacks presets for common use cases.
Features like devicons depend on nvim-web-devicons being installed, adding an extra dependency for full functionality, which the README acknowledges but doesn't bundle or simplify.
Unlike fuzzy finders, it doesn't offer search-by-name or content-based filtering, relying solely on usage patterns, which might not suit navigation needs requiring precise file lookup.
As a standalone plugin, it might not integrate seamlessly with larger ecosystems like telescope.nvim without custom keybinds or setups, and the API documentation is brief, referencing source code for details.
Frequently Asked Questions
Related Projects
bufdelete.nvimDelete Neovim buffers without losing window layout
other.nvimOpen alternative files for the current buffer
buffer_manager.nvimA simple plugin to easily manage Neovim buffers.
nvim-early-retirementSend buffers into early retirement by automatically closing them after x minutes of inactivity.
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.