slingshot 0.3.0
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
- Build from source:
- Clone the repository & navigate to cloned directory.
- Run
make build
- Run
make install
How to use
Slingshot aims to closely resemble vim motions to ensure a coherent workflow. Once started, Slingshot defaults to normal mode
.
Normal mode:
- Used for navigation.
- [J, K] can be used to navigate up and down the file list.
- [H, L] can be used to navigate back one directory, or to enter the selected directory.
- [I, A] can be used to switch to
insert mode
Insert mode:
- Used for typing the search term.
- [Enter] can be used to enter the selected file.
Global commands:
- [
Ctrl+C
] to quit application, - [
Ctrl+N
] to run commands.
Fish Shell Integration
The only requirement is to have slingshot installed.
- 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.