#command #navigate #quickly #folders #tool #user #slingshot

app slingshot-term

Lightweight command line tool to quickly navigate across folders

1 unstable release

0.2.3 Aug 25, 2023

#6 in #navigate

MIT license

33KB
822 lines

slingshot 0.2.3

Tests

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

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.

Dependencies

~2–13MB
~98K SLoC