Omahub
← All plugins
A

Aether Guard

by Aether

Read-only update preflight for Omarchy Quattro

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
36ea9c2
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
36ea9c2
Reviewed
1 month ago

The plugin performs only read-only checks of local system state and displays results. The only action it can take is launching an update via a user click, which is explicit and expected. No network access, writes, or dangerous operations are present.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/eerengz/omarchy-plugin-aether-guard --enable
System #quickshell #system #security

Aether Guard

Aether Guard is an Omarchy Quattro bar widget that checks a few local conditions before you run an Omarchy update. Its checks are read-only; it never starts an update automatically. An explicit panel button opens Omarchy's normal update flow after the user clicks it. It does not write configuration, install software, manage services, or contact the network.

Aether Guard preview

It shows:

  • the installed Omarchy version;
  • whether an Omarchy update is available;
  • whether ~/.config/omarchy/shell.json parses as version 1;
  • migrations that have not yet been recorded for this user;
  • whether Snapper has a configuration for an update-time rollback point;
  • a known initramfs warning in the current boot's update transcript;
  • a legacy OMARCHY_PATH inherited by the running shell; and
  • free space available on the home filesystem.

Requirements

  • Omarchy Quattro (4.x or later)
  • The built-in find and df commands, supplied by the standard Arch base system

Install

Install from this repository after it is public:

omarchy plugin add https://github.com/eerengz/omarchy-plugin-aether-guard.git --enable

The widget is placed in the right side of the bar. Click it to open the report; middle-click it to refresh.

Remove

omarchy plugin remove io.github.eerengz.aether-guard

Removing the plugin only removes its own plugin directory and bar entry. Aether Guard does not create or modify any other files.

Privacy and safety

All checks are local and read-only. No information leaves the computer. The only action is an explicit user click that opens Omarchy's own update terminal; the source contains no installer, package-manager action, service management, remote download, executable binary, or external Git dependency.

Publishing checklist

The permanent ID is io.github.eerengz.aether-guard. Plugin IDs are public, global identifiers: keep it lowercase, globally unique, and outside the reserved omarchy.* namespace.

Submit it as category System with the tags system, quickshell, and security. The marketplace validates and verifies a specific commit; every later release needs its own full 40-character commit SHA validation.

License

MIT. See LICENSE.