Queue-Based Note Processing Architecture | Generated by AI

Home 2026.07

Done. Here’s the corrected architecture:


Note Plugin — Queue-Based Architecture

What changed: The /note slash command no longer processes the response directly. Instead it enqueues the text content, and the separate ww note watch daemon picks it up.

Flow:

/note  (Hermes CLI)
  └→ enqueue text → ~/.config/ww/note_queue.json
                        │
            ┌───────────┴───────────┐
            │                       │
   ww note watch              cron: every 30m
   (daemon, polls 3s)        (safety net)
            │                       │
            └───────────┬───────────┘
                        ↓
               ww note process
                  ├─ LLM title gen
                  ├─ write markdown file
                  ├─ fix MathJax + tables
                  ├─ git commit + push
                  └─ clear done from queue

What’s running:

Plugin (~/.hermes/plugins/note/__init__.py):

Dependencies: ww package installed in Hermes venv, pyperclip also installed.


Back Donate