Omahub
← All plugins
D

Docker Monitor

by djjeane

Monitor Docker containers with live status, CPU, and memory usage.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
81c95ec
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

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
81c95ec
Reviewed
1 month ago

The deterministic scan found no issues, and the sampled code is a straightforward QML/Python Docker monitoring widget: background execution is read-only (`docker ps`/`docker stats`), and the only state-changing commands are user-triggered start/stop/restart/unpause actions. I rate this low rather than none solely because those Docker actions can disrupt containers if misclicked, not because of any hidden or malicious behavior.

  • The plugin uses the user's existing Docker CLI access, which is a powerful capability; it is used only for monitoring and explicitly user-triggered container controls, but a misclick could stop or restart a container.
  • No obfuscation, install-time command execution, network exfiltration, credential handling, or destructive behavior was found in the reviewed files.
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/djjeane/omarchy-docker-plugin --enable
Widgets #bar #system

Docker Monitor

An Omarchy Quattro bar widget for monitoring Docker containers.

Overview

Features

  • Compose project grouping — containers are organized by their Docker Compose project with collapsible headers
  • Live stats — CPU and memory usage for each running container
  • Container actions — start, stop, restart, and unpause containers directly from the panel
  • Log viewer — view recent container logs with timestamps
  • Desktop notifications — alerts when containers stop, become unhealthy, or start back up
  • Configurable polling — adjustable refresh interval (default 10s)

Log Viewer

Log View

Install

omarchy plugin add https://github.com/djjeane/omarchy-docker-plugin.git

Remove

omarchy plugin remove djjeane.docker-monitor

Configuration

Available settings in shell.json:

Setting Type Default Description
pollIntervalSec integer 10 Seconds between data refreshes (5–300)
showStoppedContainers boolean true Show stopped/exited containers
notificationsEnabled boolean true Desktop notifications on state changes
logLines integer 100 Number of log lines to display (25–500)

Example bar layout entry:

{
  "id": "djjeane.docker-monitor",
  "pollIntervalSec": 15,
  "notificationsEnabled": true
}

Keyboard shortcuts

Key List view Log view
r Refresh containers Reload logs
b — Back to list
esc Close panel Back to list

IPC

omarchy-shell shell toggle djjeane.docker-monitor
omarchy-shell shell summon djjeane.docker-monitor
omarchy-shell shell hide djjeane.docker-monitor

License

MIT

Requirements

  • Docker CLI (docker) accessible to the current user
  • Python 3 (for the data collection script)
  • notify-send (for desktop notifications)