How do I install zshmarks with oh-my-zsh?

Clone the repository into ~/.oh-my-zsh/custom/plugins, add 'zshmarks' to the plugins array in ~/.zshrc, and source the file. The README provides step-by-step instructions for this process.

What are the basic commands for zshmarks?

The core commands are 'jump' to navigate to a bookmark, 'bookmark' to save the current directory, 'deletemark' to remove a bookmark, and 'showmarks' to list all bookmarks. Aliases can be configured for quicker access, as detailed in the Notes/Tips section.

zshmarks vs bashmarks: which should I use?

Use zshmarks if you're on zsh with oh-my-zsh or similar frameworks; it's specifically ported for zsh. Bashmarks is for bash. zshmarks offers similar functionality but is optimized for zsh environments with integration for popular zsh plugin managers.

How can I change where zshmarks saves bookmarks?

Set the BOOKMARKS_FILE environment variable in your shell profile to the desired path. For example, add 'export BOOKMARKS_FILE="~/my-bookmarks"' to your .zshrc file, as explained in the Notes/Tips section of the README.

Is zshmarks secure for storing sensitive directory paths?

Bookmarks are stored in a plain text file by default, so if sensitive directories are bookmarked, there's no encryption. It's advisable to avoid bookmarking paths with confidential data or secure the bookmarks file with proper file permissions.

Can I use zshmarks with fish shell?

No, zshmarks is designed specifically for zsh and its frameworks. For fish shell, you would need to seek alternative bookmarking plugins or tools that are compatible with fish, as this plugin does not support other shells.

Open-Awesome

zshmarks

Shell

A command-line bookmarking plugin for oh-my-zsh that lets you save and quickly jump to frequently used directories.

GitHub

282 stars42 forks0 contributors

What is zshmarks?

zshmarks is a command-line bookmarking plugin for oh-my-zsh that allows users to save frequently accessed directories with short names and quickly jump between them. It solves the problem of navigating complex directory structures by providing simple bookmark management directly in the terminal.

Target Audience

Developers, system administrators, and power users who work extensively in the terminal and want to optimize their command-line workflow.

Value Proposition

zshmarks offers a lightweight, focused alternative to manual directory navigation, with seamless integration into popular zsh frameworks and customizable behavior through aliases and environment variables.

Overview

A port of Bashmarks (simple bookmarking plugin by Todd Werth) for oh-my-zsh

Use Cases

Best For

Quickly navigating between project directories in development workflows
Managing multiple code repositories from the command line
Accessing deep directory structures without typing long paths
Improving terminal productivity for system administrators
Creating shortcuts for frequently accessed configuration directories
Simplifying navigation in complex filesystem hierarchies

Not Ideal For

Users who need cross-shell bookmarking compatibility (e.g., regularly switching between zsh and bash)
Teams requiring bookmark synchronization across multiple machines or shared environments
Environments with strict security policies that limit or prohibit shell plugin usage

Pros & Cons

Pros

Lightweight and Minimal

Follows the Unix philosophy of doing one thing well, providing reliable directory bookmarking without unnecessary complexity, as stated in the project's philosophy section.

Seamless Zsh Integration

Designed to work with popular zsh frameworks like oh-my-zsh, antigen, prezto, and zplug, with clear installation instructions for each, making integration straightforward.

Customizable Aliases

Supports setting up short aliases (e.g., g, s, d, p) for commands, as shown in the Notes/Tips section, enabling faster and more efficient usage.

Flexible Storage Options

Allows users to change the bookmarks file location via the BOOKMARKS_FILE environment variable, offering control over where bookmark data is stored, as mentioned in the README.

Cons

Zsh-Exclusive Design

Only compatible with zsh and its frameworks, making it unsuitable for users of other shells like bash or fish, which limits its applicability in mixed-shell environments.

Manual Setup Complexity

For some frameworks like prezto, installation requires manual steps such as cloning and symlinking or editing .gitmodules, which is more involved compared to other plugins.

Deprecated Features

Has removed functionality like auto-sourcing environment files for security reasons, forcing users to rely on separate plugins like autoenv for similar capabilities, as noted in the README.

Frequently Asked Questions

Related Projects

zoxide

A smarter cd command. Supports all major shells.

Stars38,203

Forks853

Last commit3 days ago

zsh-autosuggestions

Fish-like autosuggestions for zsh

Stars35,900

Forks1,937

Last commit1 year ago

zsh-syntax-highlighting

Fish shell like syntax highlighting for Zsh.

Stars22,878

Forks1,376

Last commit5 months ago

autojump

A cd command that learns - easily navigate directories from the command line

Stars16,952

Forks708