Lucid Dreamer 🧠
Your AI sleeps. Lucid dreams.
Lucid keeps your AI's memory clean. Every night, it reads what happened, checks what your AI already knows, and suggests what's outdated, missing, or forgotten.
See README.md for full setup, ARCHITECTURE.md for internals, and config/ for configuration.
Quick Setup
-
Set your workspace path in the config:
bashexport CLAWD_DIR=/path/to/your/workspace -
Create a nightly cron job using OpenClaw's cron tool — run the prompt in
prompts/nightly-review.mdat 3 AM. -
Wake up to a review report in
memory/review/YYYY-MM-DD.md. -
Approve or reject suggestions — Lucid tracks state in
memory/review/state.json.
Files
prompts/nightly-review.md— the main nightly review promptconfig/— thresholds and behavior settingsexamples/— sample review output and state file
Security
Files read at runtime:
MEMORY.md— long-term agent memory summaryUSER.md— user profile and preferences- Last 7 daily notes (
memory/YYYY-MM-DD.md)
Files written at runtime:
memory/review/YYYY-MM-DD.md— the generated review reportmemory/review/state.json— approval/rejection tracking state
What this skill is designed to avoid:
- Avoid suggesting or outputting passwords, API keys, tokens, or other credentials in generated memory updates
- Never accesses files outside the configured workspace directory
- Never pushes to remote git automatically — all commits are local only, and no
git pushis performed unless you explicitly run it - Announce/notification delivery is opt-in and off by default — no messages are sent without explicit configuration
Recommendations:
- Set
CLAWD_DIRexplicitly in your environment to ensure the skill operates on the correct workspace - This skill reads workspace markdown files such as
MEMORY.md,USER.md, and recent daily notes. Do not run it on a workspace containing unencrypted API keys or other secrets in plain markdown files. - Review generated reports before approving suggestions — Lucid proposes changes, but you remain in control
