fzf-marks
A shell plugin for creating, managing, and navigating directory bookmarks in bash and zsh using fzf.
What is fzf-marks?
fzf-marks is a shell plugin that allows users to create and manage directory bookmarks in bash and zsh using the fuzzy-finder fzf. It solves the problem of navigating frequently used directories by providing an interactive, searchable interface for bookmarks, eliminating the need to remember or type long paths.
Developers and command-line users who work extensively in bash or zsh shells and want to streamline directory navigation through persistent, searchable bookmarks.
It offers a lightweight, customizable alternative to manual directory navigation or alias management, leveraging fzf's powerful fuzzy search for quick access to bookmarks with minimal setup.
Overview
Plugin to manage bookmarks in bash and zsh
Use Cases
Best For
- Quickly jumping between frequently accessed project directories
- Managing multiple bookmarks across different shell sessions
- Users who prefer keyboard-driven navigation with fuzzy search
- Organizing directory paths without cluttering shell aliases
- Enhancing productivity in bash or zsh workflows with persistent bookmarks
- Integrating bookmark management into existing shell plugin ecosystems
Not Ideal For
- Users on shells other than bash or zsh without fish plugin support
- Environments where installing fzf as a dependency is not feasible
- Teams needing cloud-synced or shared bookmarks across multiple machines
- Projects requiring bookmarking of files or non-directory resources
Pros & Cons
Pros
Integrates fzf's powerful search to quickly find and jump to bookmarks with minimal typing, as shown in the demo GIF and default fzm command.
Works seamlessly with bash, zsh, and fish via plugin managers like zgen and fisher, with clear installation instructions for each shell.
Allows configuration of colors, keybindings, and fzf options through environment variables, detailed in the README's customization table.
Stores marks in a simple file (~/.fzf-marks) for persistence across sessions without heavy overhead, as emphasized in the philosophy.
Cons
The plugin is entirely dependent on fzf being installed and configured, adding an extra setup step that can fail in restricted environments.
Customizing search behavior, like limiting to mark labels, requires manually adjusting fzf commands via FZF_MARKS_COMMAND, as admitted in the FAQ.
Marks are saved locally with no option for cloud sync or sharing, limiting utility in multi-machine workflows.
Frequently Asked Questions
Related Projects
zoxideA smarter cd command. Supports all major shells.
zsh-autosuggestionsFish-like autosuggestions for zsh
zsh-syntax-highlightingFish shell like syntax highlighting for Zsh.
autojumpA cd command that learns - easily navigate directories from the command line
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.