dirmux

Directory multiplexing program for managing multiple directories at once. With this you are able to tag directories and execute commands against them all at once.

This is particularly useful if you have situations such as many git repositories and you want to keep them all up to date, or have to make cross-cutting changes against all of them.

The dirmux command works from anywhere on the file system, so whenever you want to see status across your git repos or check on your TODOs it's easy and fast to do.

Motivational Examples

This command will run the 'git fetch --all' command against all known directories:

$ dirmux git fetch --all

The output will look like this (but coloured):

~/projects/blog:
Fetching origin
~/notes:
Fetching origin

As you can see above, it captures and prints the output from each command and prints it along side the directory entry. If the output is empty it will omit the directory entirely.

This is a built-in command will print a short, 1 line per directory with 'interesting' content, summary of the git repositories tagged 'work':

$ dirmux -t work status

Which will provide an output similar to this:

   ~/projects/dirmux 1M           main
     ~/projects/blog 1M 3?        main
          ~/dotfiles 1M           nvim_lsp2
             ~/notes 1?           main

If the branch is not changed and there are no modified files in the git index or working set, it will omit to print the directory.

Other examples that might be worth trying:

$ dirmux -t home rg TODO   # Finding something to do in my home projects
$ dirmux -t autosync git commit -am "Auto-sync" # Or equivalent script to also push...

Why yet-another multi-git/multi-directory tool?

I've been a long time user of gr and it's always bothered me in some ways. If you're operating on 100s of directories it's quite slow and doesn't execute the commands in parallel, and the output is quite padded. The tagging has been unintuitive for me (I've included the '@' into the tag names and confused myself many times). These led me to build this again as a fun rainy quarantine weekend Rust project.