slingshot-term
| Crates.io | slingshot-term |
| lib.rs | slingshot-term |
| version | 0.2.3 |
| created_at | 2023-08-25 19:28:06.129871+00 |
| updated_at | 2023-08-25 19:28:06.129871+00 |
| description | Lightweight command line tool to quickly navigate across folders. |
| homepage | |
| repository | |
| max_upload_size | |
| id | 954991 |
| size | 50,813 |
Caio Ishikawa (caio-ishikawa)
documentation
README
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
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.
- For folders, type the desired name followed by a
-
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.
- Toggling between Command Mode and File Explorer can be done by pressing
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.