A Neovim plugin for tagging and quickly navigating to important files with persistent cursor positions and project scopes.
Grapple.nvim is a Neovim plugin that lets you tag important files and quickly navigate between them with persistent cursor positions. It solves the problem of frequently switching between key files in a project by providing a fast, scoped tagging system. Unlike basic bookmarks, it saves your exact cursor location and supports project-specific namespaces.
Neovim users who work on multi-file projects and need efficient navigation between frequently accessed files, such as developers, sysadmins, or technical writers using Neovim as their primary editor.
Developers choose Grapple.nvim for its zero-config usability, flexible project scoping, and persistent cursor tracking. It offers a more customizable and integrated alternative to similar plugins like Harpoon, with a focus on a clean API and seamless Neovim ecosystem integration.
Neovim plugin for tagging important files
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
The README emphasizes 'frictionless first time configuration' with no setup required—just define keymaps to start tagging and navigating immediately.
Tags save exact cursor positions and restore them on jumps, as noted in the Features section, making it ideal for resuming work precisely where left off.
Supports dynamic scopes like git branches or custom definitions to namespace tags per project, detailed in the Scopes section, enabling fine-grained organization.
Offers well-documented Lua and command-line APIs for customization, plus integrations with Telescope.nvim and Portal.nvim, enhancing search and jump options.
Requires Neovim >= 0.10, excluding users on older versions or other editors, as stated in Requirements, limiting compatibility.
Defining custom scopes involves writing Lua resolver functions, which can be challenging for users unfamiliar with Lua or Neovim's APIs, as shown in the Scope API examples.
Tags are saved locally in a data directory with no built-in syncing or sharing features, hindering collaboration across teams or devices without manual workarounds.
grapple.nvim is an open-source alternative to the following products: