How to install bookmarks.nvim with lazy.nvim?

Follow the Lua snippet in the README: add it to your lazy.nvim config with dependencies like sqlite.lua and telescope.nvim, then call require('bookmarks').setup(). Ensure to backup your SQLite db on major version changes.

Bookmarks.nvim vs harpoon for Neovim?

Bookmarks.nvim focuses on persistent SQLite storage and list organization, ideal for long-term context management. Harpoon is lighter and faster for temporary marks. Choose based on need for persistence versus speed.

How to fix sqlite issues on Windows with bookmarks.nvim?

Check GitHub issue #73 for solutions, such as installing SQLite dependencies manually or adjusting system paths. The README warns about this potential hurdle for Windows users.

How to create custom keybindings for bookmarks.nvim?

Use vim.keymap.set to bind commands like BookmarksMark to your preferred keys, as shown in the README examples. You can also create custom commands by calling functions from the commands module.

Does bookmarks.nvim support multiple bookmark lists?

Yes, it allows creating and switching between multiple bookmark lists using commands like BookmarksNewList and BookmarksLists, enabling organized separation by project or context.

How to integrate bookmarks.nvim with Aider?

Add nvim-aider as an optional dependency in your config, then use keymaps like '+' in the treeview to add bookmarks to Aider, as detailed in the advanced usage section.

bookmarks.nvim

MITLuav4.0.0

A Neovim plugin for persistent, organized bookmarks with SQLite storage, tree view, and telescope integration.

Visit Website

What is bookmarks.nvim?

Bookmarks.nvim is a Neovim plugin that provides persistent, named bookmarks stored in a SQLite database. It helps developers organize thoughts, navigate codebases efficiently, and maintain context across editing sessions by allowing bookmarks to be arranged into customizable lists and visualized directly in the editor.

Target Audience

Neovim users, particularly software developers and engineers who work in large or complex codebases and need a persistent, organized system for marking and returning to specific lines of code across sessions.

Value Proposition

Developers choose Bookmarks.nvim for its persistent SQLite storage that survives editor restarts, its flexible organization into lists, and its deep integration with Neovim tools like Telescope for navigation. It minimizes keyboard shortcuts while offering powerful features like visual line indicators, rich metadata, and window splitting operations.

Overview

Persistent bookmarks: hard disk of your thoughts

Use Cases

Best For

Neovim users needing persistent bookmarks that survive editor restarts and system reboots.

Related Projects

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

GitHub

290 stars14 forks0 contributors

Developers working across multiple projects or contexts who want to organize bookmarks into separate, customizable lists.

Teams or individuals navigating large codebases who require efficient jumping to marked locations using Telescope pickers or a tree view.

Programmers who want to attach descriptive names and notes to bookmarks for additional context and recall.

Neovim power users seeking advanced bookmark operations like opening in splits/tabs, deletion shortcuts, and integration with tools like Aider.

Developers who prefer visual indicators, such as icons and syntax highlighting, to see bookmarks directly within their code buffers.

Not Ideal For

Users of Vim or other editors without Neovim compatibility
Developers who need instant, zero-configuration bookmarks with default keybindings
Teams on Windows systems prone to sqlite dependency issues
Projects using picker systems other than Telescope without available community integrations

Pros & Cons

Pros

Persistent SQLite Storage

Bookmarks are saved to a SQLite database file, ensuring they survive editor restarts and system reboots, as highlighted in the README's key features.

Customizable Organization

Allows arranging bookmarks into customizable lists for better project or context management, enabling flexible workflow adaptation as described.

Visual Buffer Indicators

Displays icons and names at marked lines with syntax highlighting, providing immediate visibility of bookmarks directly in the code editor.

Telescope Integration

Offers flexible navigation using Telescope pickers for finding and jumping to bookmarks, with support for splits, tabs, and deletion shortcuts.

Cons

Limited Picker Support

Currently only supports Telescope for pickers; integration with other pickers requires community contributions or PRs, as admitted in the README dependencies.

Complex Setup on Windows

Windows users may encounter sqlite dependency issues, requiring additional troubleshooting as noted in issue #73, which can hinder quick adoption.

No Default Keybindings

The plugin does not provide any default key mappings, forcing users to manually configure shortcuts, increasing initial setup time and complexity.

Frequently Asked Questions

Home

Neovim

harpoon

Harpoon is a Neovim plugin designed to solve the repetitive navigation problem in software development. It allows users to mark frequently accessed files and terminals within a project, providing quick keyboard-driven access to reduce context switching and boost productivity. ## Key Features - **Persistent File Marks** — Mark important files per-project with positions that auto-update as you edit. - **Quick Navigation Menu** — Toggle a menu to view, reorder, or jump to marked files instantly. - **Terminal Management** — Create, navigate between, and send commands to multiple persistent terminal sessions. - **Tmux Integration** — Seamlessly control tmux windows and panes directly from Neovim. - **Telescope Extension** — Browse and select marks using the popular Telescope fuzzy finder. - **Customizable Configuration** — Adjust settings like save behavior, excluded filetypes, and menu appearance. ## Philosophy Harpoon emphasizes minimal keystrokes and persistent, project-aware navigation, treating files and terminals as equally important resources in a developer's workflow.

Stars9,107

Forks483

Last commit7 months ago

marks.nvim

A better user experience for viewing and interacting with Vim marks.

Stars1,164

Forks55

Last commit1 year ago

arrow.nvim

Bookmark your files, separated by project, and quickly navigate through them.

Stars741

Forks41

Last commit6 months ago

grapple.nvim

Neovim plugin for tagging important files

Stars709

Forks32

Last commit1 year ago