Skip to content

Latest commit

 

History

History
48 lines (32 loc) · 1.81 KB

README.md

File metadata and controls

48 lines (32 loc) · 1.81 KB

autols.fish

Automatically run ls whenever you enter a different directory. Add ignore rules to ignore certain directories. Works with fish built-in cd, cdh and shell agnostic programs such as zoxide.

Installation

Using Fisher

fisher install kpbaks/autols.fish

Usage

autols.fish is enabled by default. You can disable it by using the provided function autols.

autols off # disable autols
autols on  # enable autols
autols status # check if autols is enabled
autols toggle # toggle autols

Ignore rules

You can add ignore rules to ignore certain directories. This is useful if you have a directory with a lot of files, and you don't want to run ls every time you enter it. Ignore rules are edited using the autols function.

autols ignore add <directory> # add a directory to the ignore list
autols ignore "*/build/" # Ignore all directories named build
autols ignore rm <directory> # remove a directory from the ignore list
autols ignore list # list all ignored directories
autols ignore clear # clear all ignored directories

See autols --help for more information.

Inspiration

How it works

fish has an event system that allows you to run functions when certain events occur. In this case, we want to run ls whenever we enter a new directory. To do this, we listen to the fish_postexec event, and check if the current directory is different from the previous one. If it is, we run ls and update the previous directory.