Skip to content
githubInstall · free

~ $ cat docs/omarchy.md

Chasen on Omarchy

On Omarchy, Chasen fits in three places: the menu of apps, the top bar, and the colors of your theme. Each one is one command.

Terminal window
omarchy-tui-install Chasen chasen tile https://chasenhq.com/icon.png

Chasen is now in the app launcher (Super + Space). It opens the screen of your servers in a terminal of its own.

The plugin omarchy-chasen puts a server icon in the bar of Omarchy. It turns while a deploy runs, on any of your servers. It is dim when all is well, normal when a server has a warning, and in the urgent color when an app is down or a server has an error. A click opens the tree: each server with its alerts and its apps. Enter opens the screen.

Terminal window
omarchy plugin add https://github.com/karloscodes/omarchy-chasen.git --enable

It runs one chasen overview --watch for as long as the bar runs. That keeps one connection open to each server that you are logged in to, so it logs in once, not at each ask. It asks once a minute, and every 5 seconds while a deploy runs. Each ask is one docker ps and one read of the database on the server. The reference lists the alerts. To remove it: omarchy plugin remove karloscodes.chasen.

With an Omarchy that has Waybar (before its own shell), add a module instead. Put "custom/chasen" in modules-right of ~/.config/waybar/config.jsonc, add this next to the other modules, and run omarchy-restart-waybar:

"custom/chasen": {
"exec": "chasen alerts --waybar",
"return-type": "json",
"interval": 60,
"on-click": "omarchy-launch-tui chasen"
}

Press t in the screen until it says terminal. The screen then uses the colors of your terminal, and Omarchy sets those colors for each theme, so the screen changes with every theme you switch to. The screen remembers the choice.