| name | hermes-dreaming |
| description | Use when Hermes needs staged self-improvement, explicit reviewable artifacts, or safe apply/discard workflows for memory, user, skill, or fact updates. |
Hermes Dreaming
Use this plugin when you want staged, reviewable self-improvement instead of silent writes.
Core idea
Hermes-dreaming scans explicit source inputs, stages proposed changes in an artifact directory, and only writes to live state after an explicit apply step. It is designed for local-first, reviewable updates.
When to use
- You want to convert notes or
DREAM: markers into staged proposals.
- You want a reviewable diff before anything touches live state.
- You want explicit apply/discard gates.
- You want to keep backups and archives under separate roots.
Main commands
dreaming create --live-root ./live --artifact-root ./artifacts --source ./sources
dreaming review --live-root ./live --artifact-root ./artifacts --source ./sources
dreaming review --open ./artifacts/<artifact-id>
dreaming summarize ./artifacts/<artifact-id>
dreaming approve ./artifacts/<artifact-id> all
dreaming reject ./artifacts/<artifact-id> <proposal-id> --reason "too broad"
dreaming diff ./artifacts/<artifact-id> --live-root ./live
dreaming validate ./artifacts/<artifact-id> --live-root ./live
dreaming apply ./artifacts/<artifact-id> --live-root ./live --backup-root ./backups
dreaming discard ./artifacts/<artifact-id> --archive-root ./archive
dreaming compact --artifact-root ./artifacts --archive-root ./archive
dreaming install-cron --schedule "0 3 * * *"
dreaming status --artifact-root ./artifacts
dreaming update
Safe usage pattern
- Keep the live root small and explicit.
- Put generated artifacts in a separate artifact root.
- Use
review --open or to understand the current decision state.
