Clairvoyance
/install clairvoyance
Clairvoyance
Insight system based on memory pattern analysis.
What it does
Reads the user's own local memory files to find:
- Recurring themes across recent notes and dreams
- Tensions between stated goals and actual actions
- Convergences between projects or ideas
- Forgotten threads that keep surfacing
Data access (read-only, local only)
When the user explicitly requests a clairvoyance reading, the agent reads:
| Path | Purpose |
|---|---|
memory/.dreams/events.jsonl |
Recent dream/reflection events |
memory/.dreams/phase-signals.json |
Sleep phase signals |
memory/YYYY-MM-DD.md |
Daily notes from last 7-30 days |
MEMORY.md |
Long-term curated memory |
Important:
- Read-only. Nothing is written, modified, or transmitted externally.
- Local files only. No API calls, no cloud uploads.
- Triggered only by explicit user request. Never runs automatically.
When to use
- User asks "do a clairvoyance" or "what patterns do you see?"
- User explicitly requests a different perspective on their situation
- User asks to analyze their recent notes or dreams
How to respond
- Read the local memory files listed above
- Look for:
- Recurring themes — words, topics, or ideas that appear across multiple days
- Tensions — contradictions between goals and actions
- Convergences — separate projects/ideas moving toward the same point
- Forgotten threads — important things mentioned once then abandoned
- Repetitions — same mistakes or negative patterns
- Formulate suggestions indirectly:
- Never "You must..." or "You should..."
- Prefer "I notice that...", "A convergence emerges...", "The patterns suggest..."
- Ask open questions
- Offer metaphors when helpful
- Calibrate certainty:
- Strong: Clear pattern, multiple evidence points
- Moderate: Interesting indication, worth verifying
- Subtle: Dream-based intuition, suggest lightly
Output format
Use sections with emoji markers and certainty levels:
### 1. [Title] (certainty: strong/moderate/subtle)
[Observation based on data]
[Question or metaphor]
End with a closing metaphor if one fits naturally.
What NOT to do
- Do not run automatically or on heartbeat
- Do not write to any files
- Do not send data anywhere
- Do not claim absolute truth — suggest possibilities only
- Do not impose interpretations — invite reflection
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install clairvoyance - After installation, invoke the skill by name or use
/clairvoyance - Provide required inputs per the skill's parameter spec and get structured output
What is Clairvoyance?
User-invoked insight system that reads local memory files (dream logs, daily notes, MEMORY.md) to surface hidden convergences, tensions, and forgotten thread... It is an AI Agent Skill for Claude Code / OpenClaw, with 61 downloads so far.
How do I install Clairvoyance?
Run "/install clairvoyance" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Clairvoyance free?
Yes, Clairvoyance is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Clairvoyance support?
Clairvoyance is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Clairvoyance?
It is built and maintained by srmhrrm-hub (@srmhrrm-hub); the current version is v1.0.5.