Omahub
← All plugins
L

AirGradient

by lgw

Live air quality from your AirGradient monitor via the AirGradient cloud API, with a color-coded bar pill and a details panel.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
15d1bcf
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
15d1bcf
Reviewed
1 month ago

The plugin is a straightforward AirGradient air-quality widget that fetches data from the official AirGradient cloud API using a user-provided token. The code is clean, well-documented, and contains no obfuscation, hidden behavior, or destructive operations. The only network interaction is with api.airgradient.com, and the API token is handled as expected for this service.

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/lukewalker2010/omarchy-airgradient --enable
Other #bar

AirGradient

A Quattro shell plugin that shows live air quality from your AirGradient monitor in the Omarchy bar.

The bar shows a compact pill with PM2.5, CO₂, temperature, and humidity — exposure metrics get a color-coded dot (green → yellow → orange → red → purple). Click it for a details panel with all six metrics (plus PM10 and TVOC); middle-click refreshes; right-click opens your AirGradient dashboard. The panel includes a location dropdown to switch which monitor the widget reports, so you do not need a terminal for day-to-day changes.

Data is polled from the AirGradient cloud API every minute, so it works from any network. The dot and metric colors follow standard exposure bands.

Install

The plugin is a folder under ~/.config/omarchy/plugins/lgw.airgradient/. Enable it and drop it on the bar:

omarchy plugin enable lgw.airgradient
omarchy bar put lgw.airgradient --section right

Saved edits under ~/.config/omarchy/plugins/ hot-reload automatically. Force a rediscovery with omarchy-shell shell rescanPlugins if needed.

Configure

  1. Open app.airgradient.com and sign in.

  2. Go to General Settings → Connectivity and enable API access. Copy the API token it shows you.

  3. Open Locations Administration. The location ID is the number in the first column of the table for your monitor.

  4. Set the plugin settings either:

    • through the Omarchy plugin settings panel (Setup → Plugins), or
    • directly:
    omarchy bar set lgw.airgradient apiToken <YOUR-API-TOKEN>
omarchy bar set lgw.airgradient locationId <YOUR-LOCATION-ID>

Optional settings:

omarchy bar set lgw.airgradient refreshIntervalSec 120   # poll seconds, min 10

The pill is always visible once the widget is on the bar and shows "–" until the first reading arrives. A wrong token or ID shows the API error on the panel instead of silently failing. The location dropdown refreshes the list from the account's bulk endpoint whenever the panel opens, so newly added monitors appear without restarting anything.

Develop / publish

The plugin is a git repository:

cd ~/.config/omarchy/plugins/lgw.airgradient
git log        # current state

Push it to GitHub/GitLab, then anyone can install it with:

omarchy plugin add https://github.com/YOUR-NAME/omarchy-airgradient.git --enable

Install from your own checkout with the same commands as any hand-installed plugin. See the Omarchy plugin development guide for the publishing checklist.

Security

The plugin runs unsandboxed inside omarchy-shell, like every Omarchy plugin. Your API token is stored in ~/.config/omarchy/shell.json (mode 0600) and is sent to api.airgradient.com only. The token is never logged and never appears in any process's command-line arguments — curl reads the URL from a pipe, not from argv, so it is invisible to ps and /proc/PID/cmdline. The token is still present in the omarchy-shell process's memory while the request is in flight.

Files

  • manifest.json — plugin manifest and settings schema
  • BarWidget.qml — bar pill + panel lifecycle
  • Panel.qml — polling, error handling, and the details panel
  • Model.js — response parsing, formatting, and exposure bands
  • preview.png — marketplace listing preview