ZapMarks

Quick access to your most-used command-line bookmarks for Zsh

ZapMarks is a powerful Zsh plugin that streamlines your command-line workflow by providing instant access to frequently used commands through an intuitive bookmark system.

✨ Features

• 🔍 Smart Search: Fuzzy search through your bookmarked commands
• 👀 Command Preview: See command details before execution
• ⚡️ Quick Add: Bookmark new commands directly from the terminal
• 🛠 Easy Management: Edit bookmarks with your preferred editor
• 🚀 High Performance: Optimized performance using fzf and jq

🚀 Quick Start

bash -c "$(curl -fsSL https://raw.githubusercontent.com/iliutaadrian/zapmarks/main/scripts/install.sh)"

After installation, restart your terminal or run:

source ~/.zshrc

📋 Prerequisites

Before installing, ensure you have:

• Zsh shell
• fzf - Command-line fuzzy finder
• jq - Lightweight command-line JSON processor

💻 Installation

Option 1: Automated Installation (Recommended)

The automated installation script will:

1. Clone the repository to the appropriate location
2. Configure your Zsh setup
3. Install the default bookmarks file

Option 2: Manual Installation

1. Clone the repository:

   git clone https://github.com/iliutaadrian/zapmarks.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zapmarks
   

2. Run the installation script:

   ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zapmarks/scripts/install.sh
   

3. Add the plugin to your .zshrc:

   plugins=(... zapmarks)
   

🎯 Usage

Basic Commands

Command	Description
CTR+B	Open the bookmark fuzzy finder
zapmarks-add	Add a new bookmark
zapmarks-edit	Edit bookmarks file

Example Workflow

1. Save a frequently used command:

   zapmarks-add
   # Follow the prompts to add your command
   

2. Press Alt+B to access your bookmarks

3. Type to fuzzy search through your commands

4. Press Enter to execute the selected command

📁 Configuration

ZapMarks stores its configuration in ~/.zapmarks.json. The file structure is:

{
  "bookmarks": [
    {
      "command": "git status",
      "description": "Check git status",
      "tags": ["git", "status"]
    }
  ]
}

🙏 Acknowledgments

• fzf for the amazing fuzzy finder
• jq for JSON processing
• Oh My Zsh for the plugin infrastructure