Omahub
← All plugins
M

Easy Kanban

by Matthieu G.C.

Local Kanban boards from the Omarchy bar

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
109078a
Scanned
2 weeks 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
109078a
Reviewed
2 weeks ago

This is a local-only Kanban bar widget. It writes a JSON state file under ~/.local/state/omarchy and invokes fixed, non-shell commands (mkdir, cp, omarchy-notification-send); there is no network access, obfuscation, or destructive behavior. The deterministic scan found no issues, and manual review confirms the code is consistent with its documented behavior.

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/ypMrg/omarchy-easy-kanban --enable
Productivity #bar #quickshell

Easy Kanban

Local Kanban boards from the Omarchy bar. Multiple boards, columns, drag-and-drop tickets, and deadline reminders — all stored on disk, no network.

Install

omarchy plugin add https://github.com/ypMrg/omarchy-easy-kanban.git --enable

Update / Remove

Plugin id: io.github.ypmrg.omarchy-easy-kanban

omarchy plugin update io.github.ypmrg.omarchy-easy-kanban
omarchy plugin remove io.github.ypmrg.omarchy-easy-kanban

Default board

On first run (or after a corrupt data file is recovered), one board is created:

Board Columns
Personal Todo, In Progress, Done (empty)

New boards get the same three default columns (new ids, empty tickets).

Data path

Boards are saved locally to:

~/.local/state/omarchy/easy-kanban.json

There is no cloud sync. Every bar instance shares this file, including one widget per monitor: a save on one screen reloads the others. A bad file is copied to easy-kanban.json.bak and replaced with a clean default on the next save.

Hover recap

The bar shows only the Easy Kanban icon. Hover the icon (with the panel closed) for a short recap of the active board: column names with ticket counts, plus an overdue count (tickets past their deadline, excluding Done columns).

Drag and keyboard

Click the bar icon to open the board panel. Drag a card to move it between columns or reorder within a column. Click a card to focus it (accent ring), then use keys:

Key Action
Esc Close the open dialog, or the panel if none
N New ticket in the focused card’s column (first if none)
Del Delete the focused card (asks for confirmation)
Arrows / HJKL Move focus to another card or empty column
Shift + arrows Move the focused card (column or order)

Keys at the edge of a board or column are no-ops. Move keys are ignored while a dialog or text field is open. When columns overflow the panel, moving a card (keyboard or drag) scrolls the hidden columns into view.

Deadlines and reminders

Tickets may have an optional deadline (YYYY-MM-DD). Cards show Due today or Overdue badges.

The bar widget watches deadlines while it is loaded:

  • On load, every 60 seconds, and when the local calendar day rolls over
  • Tickets in columns named Done (case-insensitive) are skipped
  • Each ticket is notified at most once per local day
  • At most 5 notifications per tick; the rest wait for the next tick

Reminders require the widget to stay on the bar. If you remove the widget from the bar, the watcher is not running and no deadline notifications are sent.

Requirements

  • Omarchy Quattro (or newer with the plugin system)
  • Bar widget support and desktop notifications (omarchy-notification-send)

License

MIT — Copyright (c) 2026 Matthieu G.C.