Skip to content

A command line tool to move between directories easily. Written in Go

License

Notifications You must be signed in to change notification settings

vyshnav-vinod/pathfinder

Repository files navigation

pathfinder

Version : v0.1.2 Build : 202405242303

Pathfinder is a command-line tool that helps you navigate between directories without needing to specify the entire path. Simply specify the name of the directory you want to switch to, and Pathfinder will handle the rest. It also supports specifying entire paths if needed.

Features

  • Quickly switch from one directory to another without entering the full path
  • Mention the parent directory to avoid jumping to other unwanted folders
  • Pathfinder also supports full paths
  • Use the -b flag to get back to the previous directory you were in
  • Uses a cache to store frequently visited directories, so you can move between them faster

Installation

Warning

Pathfinder is only tested in Linux right now. This will not work on Windows!!

  • Clone this repository
git clone https://github.com/vyshnav-vinod/pathfinder.git
  • Move into the cloned folder
cd path/to/clone
  • Mark install.sh as executable
chmod +x install.sh
  • Run install.sh
./install.sh

Note

This will create a alias named pf in your .bashrc and also a pathfinder.sh script which is required to run pathfinder

  • If successful, reload the terminal or use the source command
source ~/.bashrc

You are good to go. Check below usage and examples to start using pathfinder. If you were stuck or unable to install, please raise an issue and i will help you.

Usage

pf [directory name/path] (flags)

Flags

  • -b, --back : Move back to the previous directory from where pathfinder was called.
  • -i, --ignore : Ignore searching for the folder in the current directory.
  • --clean : Clean the cache. If you encounter any unexpected behaviour, try this.
  • --info : Display version and build number.
  • -h, --help : Display the help message.

Examples

  • Go to the folder named dirname
pf dirname
  • Go to the folder named dirname under the parentdir folder
pf parentdir/dirname
  • Go to the folder named dirname using full path
pf ~/Desktop/dirname
  • Go back to previous directory
pf -b

Issues

Pathfinder is still in early stages. You can raise an issue and i will be glad to help.

Contributing

Do you have a new feature idea? Or do you want to improve the performance? Or know how to fix a bug? You can raise a new Pull Request. If you are adding a new feature, please open a issue stating what you will add to pathfinder and then you are good to go. If you feel stuck with something, raise an issue and i will be happy to help.

About

A command line tool to move between directories easily. Written in Go

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published