slingshot 0.2.3

Slingshot is a lightweight tool to browse files in the terminal. It allows the user to quickly filter through files in any directory, open them with a text editor (nvim by default), create/edit/delete files , and run commands in a simple interface.

Design Goals

• A quick way to navigate, create and edit files in the terminal.
• Easily maintanable.
• Minimal use of third party crates.

Dependencies

• Rust & Cargo
• Nerdfonts

How to install

• Clone the repository & navigate to cloned directory.
• Run make build
• Run make install

How to use

• Moving up/down:

  • Arrow Keys
  • Ctrl+J/Ctrl+K

• Creating folders/files:

  • For folders, type the desired name followed by a /.
  • For files, type the name of the desired file with the file extension (e.g. .py, .txt, etc.)
  • Confirm creation by pressing Enter.

• Deleting files/folders:

  • Marking files/folders for deletion is done by pressing Ctrl+D, which will highlight the item red.
  • Confirm by pressing Ctrl+Y.

• Command mode:

  • Toggling between Command Mode and File Explorer can be done by pressing Ctrl+N.
  • To run the command, type it and confirm with Enter.

Fish Shell Integration

The only requirement is to have slingshot installed.

1. Run fisher install caio-ishikawa/slingshot-fish.

The default keybind to open slingshot in the fish shell is Ctrl+S.

Known issues

• Scrolling/overflows do not work. (filtering is not affected.)
• Crashes if user tries to move back from home directory.