Interactive Omarchy Command Explorer

[sean-imus]

Hello all,

I wanted to share a command that has helped me many times.

It lists all available omarchy commands and displays their source code in a clean fzf interface with a bat preview. Most omarchy commands are self-explanatory because their source files are well commented, and this makes it easy to browse and understand them.

The setup is simple and can be used in two ways.

Option 1 (Script)

1. Create a file called omarchys under ~/.local/bin (or any directory in your $PATH):

mkdir -p ~/.local/bin && touch ~/.local/bin/omarchys

2. Paste the following into the file and save it:

#!/bin/bash

compgen -c | grep -E '^omarchy-' | sort -u | fzf --style=full --preview "bat --style=numbers --color=always \$(which {})" --preview-window=right,65%,wrap

3. Make it executable:

chmod +x ~/.local/bin/omarchys

4. Run omarchys wherever you like.

---

Option 2 (One-liner)

1. Copy and paste this command into your terminal:

compgen -c | grep -E '^omarchy-' | sort -u | fzf --style=full --preview "bat --style=numbers --color=always \$(which {})" --preview-window=right,65%,wrap

2. Use CTRL + R in your terminal and search for something like fzf or compgen to quickly find it again later.

---

Explanation

How does this command work?

1. compgen -c generates all available commands in your shell and passes them to the next command via |

2. grep -E '^omarchy-' filters for commands that begin with omarchy-

3. sort -u sorts the results and removes duplicates (important because commands show up multiple times without it)

4. fzf provides the interactive interface:

   • fzf --style=full --preview --preview-window=right,65%,wrap defines the layout and enables fuzzy searching
   • "bat --style=numbers --color=always \$(which {})" runs in the preview window and shows the source code of the selected command using bat

---

Notes

I debated adding functionality to execute the selected command by pressing Enter directly from fzf. However, this was too risky because some omarchy commands can have serious side effects. Currently, pressing Enter only prints the command name to the terminal.

---

Preview

[EERomeo]

Cool and usefull, thanks!