Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

iliutaadrian/zapmarks

Open more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ZapMarks

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

Screenshot 2024-10-13 at 11 09 56

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

About

Zsh plugin that provides quick access to your most used command-line bookmarks

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

Morty Proxy This is a proxified and sanitized view of the page, visit original site.