π» Demo β’ βοΈ Install & Update β’ π Contribution β’ βKnown Issues
It's a pain to cd
and ls
multiple times to reach desired directory in terminal (this maybe subjective). ls-Xtended (lsx) solves this problem by allowing users to smoothly navigate and search directories on the go with just one command. It also allows to create alias for paths making it easier for users to remember the path to the desired directory.
It also ranks your directories based on how often you access them and placing them on top of the list to reduce searching and navigation time.
Note: once you reach the desired destination, use
ctr+c
to exit and stay in the desired destination
- use
/
to trigger search and start typing to search
lsx
Show hidden files as well
lsx -a
lsx set-alias -n somealias -p path/to/be/aliased
or
lsx set-alias --path-name somealias --path path/to/be/aliased
set-alias
can also be used to update any existing alias. Let's say alias abc
already exists for path a/b/c
. on can update it like so:
lsx set-alias -n abc -p d/e/f
lsx alias
lsx somealias
lsx remove-alias aliasname
- Must have Go installed
- GOPATH is set and
$GOPATH/bin
is added to PATH
curl https://github.com/raw/souvikinator/lsx/master/install.sh | bash
and you are ready to go, restart your terminal. Enjoy!
Note: zsh, bash and fish shell users just need to run the installation script and lsx will be ready to use. In case the command is not working add following line at the end of your shell resource file (
.bashrc
,.zshrc
...):
source ~/.config/lsx/lsx.sh
and then restart your terminal
open an issue if still facing installation problems
running the command used for installing updates
lsx
restart your terminal and you are good to go.
You can improve this project by contributing in following ways:
- report bugs
- fix issues
- request features
- asking questions (just open an issue)
and any other way if not mentioned here.
As of now the installation process is painful and the reason is a program runs as a child process in a terminal so eveything happens withing that child process. When we change the directory from go program the directory changes for that executable or to be specific "for that child process" and not of the shell. Which is why one needs to source a script in their shell resource file (.zshrc
, .bashrc
...).
The script contains a bash function as a wrapper around the lsx binary to make the whole cd
thing work. This is what is prevent lsx to be distributed using some package manager.
If anyone can comeup with something then feel free to open issue.