4 releases (2 breaking)

0.3.0 Dec 22, 2024
0.2.1 Dec 8, 2024
0.2.0 Dec 3, 2024
0.1.0 Dec 1, 2024

#31 in Command line utilities

Download history 178/week @ 2024-11-27 296/week @ 2024-12-04 30/week @ 2024-12-11 98/week @ 2024-12-18 30/week @ 2024-12-25

510 downloads per month

BSD-3-Clause

40KB
1K SLoC

FiLe InteRacT, the file interaction tool for your command line

This is a small program that starts an interactive file selection process from your current pwd and allows you to select relative files, returning them to your command line once you are done.

Examples below invoke flirt with a keybinding set on ^s.

Interactive cd

asciicast

Let’s say you would like to locate a directory, but you also want to grab information about the structure of the parent directories — a very common case during new code base exploration. A typical way is to do that with a fuzzy finder – many people use [fzf] with its c-t binding that opens a fuzzy picker to search for files:

cd ^t

However, this is not always wanted, especially when you do not know exactly what you are looking for, and are in exploration mode. Instead, you can start an interactive cd like so:

cd ^s

This will start flirt and will allow you to move around the filesystem. Once you have found the target directory, just end your interactive session (q by default) and you should have the path of the directory to go to in your cd command line.

Interactive move

asciicast

flirt expands all the selected paths on the command line, so you can use it for commands that expect several arguments. For instance, let’s say you would like to move a file from a directory into another one, without being entirely sure about the files you need to move nor where:

mv ^s

Interactive tar creation

asciicast

A more complex example is tarball creation. Write the static part of the command (tar -cvf tarball.tar.gz) and let flirt do the rest for you!

Interactively run commands on different files

asciicast

A very powerful workflow: pick some files and edit in your favorite $EDITOR commands to run on them. Once you close your editor, the commands are run.

Filtering

asciicast

Filtering allows to filter the content of the current directory with a regex, providing a nice way to cut the number of files down to what you need.

User Guide

Please find the user guide here.

Installation guide

Archlinux

You can use the AUR to install the flirt package. Follow these recommended steps:

mkdir ~/aur && cd ~/aur
git clone https://aur.archlinux.org/flirt.git && cd flirt
# inspect the PKGBUILD; YOU SHOULD ALWAYS DO THIS ON THE AUR!
makepkg -cis

Dependencies

~7–17MB
~240K SLoC