#directory #mark #book #goto #remove #name #config-file

bin+lib quickclip

A CLA that allows you to book mark important directories

5 releases

0.1.4 Jul 24, 2023
0.1.3 Jul 16, 2023
0.1.2 Jul 11, 2023
0.1.1 Jun 30, 2023
0.1.0 Jun 30, 2023

#1035 in Filesystem

32 downloads per month

MIT license

405KB
192 lines

Quickclip

A directory book marker written in rust 🦀!

Demo

Installation

with cargo run : cargo install quickclip
then add your respective shells startup script:

fish
add `quickclip init fish | source` to your config file. this is usually in fish.config
zsh
add `eval "$(quickclip init zsh)"` to your config file. this is usually in .zshrc
bash
add `eval "$(quickclip init bash)"` to your config file. this is usually in .bashrc

Usage

  • add new mark with quickclip {NAME}
    • if NAME is not specified, it will default to the folder name.
  • list all marks with quickclip list
  • remove a clip with quickclip remove {NAME}
  • go to a saved directory with goto {NAME}
    • if NAME is un specified it will open a TUI with all your saved directories

Tips

  • Saving quickclip as an alias for your shell such as alias qc = quickclip
  • create a shell goto function to cd to the output of the quickclip goto command ie (in fish) :
# set to cd using bookmarks
function goto
  set -l path (command quickclip goto $argv)
  cd -- "$path"
end

Roadmap

Eventually I would like to add a fuzzy finder to the tui for selecting the book mark. Currently, though I am more focused on polishing up the current features such as:

  • Better error handling
  • confirming before overwriting a book mark
  • auto creation of the goto shell function

Dependencies

~7–18MB
~186K SLoC