GitHub Actions in the Omarchy bar.
Tell it which repos to watch and the bar shows a test-tube pill: a spinner while a run is in progress, red when your latest run failed, green when it passed. Click it for each repo's latest runs and the selected run's jobs, steps and log; open, retry or cancel a run from the keyboard. You get a desktop notification when a run you started finishes.
Needs the GitHub CLI signed in (gh auth login); omarci uses its login and nothing else.
omarchy plugin add https://github.com/matiacone/omarci.git --enable
ln -sf ~/.config/omarchy/plugins/io.github.matiacone.omarci/bin/omarci ~/.local/bin/omarciThe widget lands on the right. Move it if you want:
omarchy bar move io.github.matiacone.omarci --section right --before omarchy.agentsAdd repos from the panel (the gear → Watched repos, paste owner/repo or a github.com URL), or from a terminal:
omarci repos add owner/repo
omarci repos remove owner/repo
omarci repos # listDown the left, a card per watched repo with its latest 10 runs: status, workflow, branch, commit title, how long ago. On the right, the selected run's jobs and steps and the end of its log: the failed jobs' log when something failed, the whole run's otherwise. GitHub has no log for a run still in progress; its steps refresh every few seconds instead. The widget syncs every 15 s while a run is in progress and every minute otherwise.
Keys for the selected run:
| Key | Does |
|---|---|
Enter (or double-click) |
Opens the run on github.com |
r |
Retries: re-runs a failed run's failed jobs, or the whole run otherwise |
c |
Cancels a run in progress (also the Cancel button top right) |
j / k select, s opens settings (the gear), Esc closes. A finished run's details are cached, and the newest are fetched ahead in the background, so selecting a run is instant.
The same actions work from a terminal:
omarci gh sync # refresh now
omarci gh open owner/repo RUN_ID
omarci gh rerun owner/repo RUN_ID [--failed]
omarci gh cancel owner/repo RUN_ID
omarci gh log owner/repo RUN_ID [--all] # failed jobs' log, or all of it
omarci gh view owner/repo RUN_ID # jobs, steps and log tail as JSON (cached once finished)Turn notifications off with the toggle in settings, or OMARCI_NOTIFY=0. OMARCI_DIR overrides the state directory ($XDG_STATE_HOME/omarci).
omarchy plugin update io.github.matiacone.omarciomarchy plugin remove io.github.matiacone.omarci
rm -f ~/.local/bin/omarciSettings and cached runs in ~/.local/state/omarci/ are left in place.
Omarci runs unsandboxed inside omarchy-shell when enabled. Review the source before installing.
- Files: reads and writes
$XDG_STATE_HOME/omarci/: settings with the watched repos,github.jsonwith their latest runs, andruns/with finished runs' details (dropped after a week). Toggling notifications may update this plugin's entry in~/.config/omarchy/shell.json. - Commands:
ghfor everything GitHub (it uses yourghlogin; omarci never sees a token);xdg-opento open a run;notify-sendwhen a run you started finishes. - Network: only through
gh, to the GitHub API, for the repos you watch: reading runs and their logs, and re-running or cancelling the ones you choose. - Privilege: no sudo, no install hooks.
MIT
