R
Redskull-127/lucid
One shared dream for every Claude agent: live plan, evidence-backed decision log and file claims for the lead, subagents and Agent Teams.
updated 2026-11-18
View on GitHub ↗Link checked 2026-11-17 · HTTP 200 · opens the vendor's own site
- Star count
- 0 ★ · Redskull-127/lucid · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-17 · last seen 2026-11-20 · seen 4× · listed by 2 sources
- Score
- score 203 · 2 sources · repo
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: Open Source. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
Redskull-127/lucid;first catalogued 2026-11-17;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
lucid
Excerpted from the repository README (abridged)
One shared dream for every Claude.
A live plan, an evidence-backed memory and file claims shared by the lead agent, its subagents and Agent-Teams teammates.
Change the plan partway through and every running worker sees the change before its next action.
Install ·
How it works ·
Benchmark ·
Commands ·
Real run ·
Limits
## 🌙 The problem
You build a feature with several Claude agents working at once, then change your mind partway through. Things go wrong:
| Symptom | Why it happens |
| 🧭 Plan drift | Workers that are already running still follow the plan they were spawned with. Nothing tells them it changed. |
| 📉 Lossy handoffs | A subagent's summary leaves out the why, and leaves out the "we tried X, it broke". |
| 🔁 Repeated work | Every worker re-reads and re-searches the same code. |
| 🫥 Compaction amnesia | Decisions disappear when the conversation is compacted and in new sessions. |
| 💥 Overwritten work | Two agents edit the same file and one loses its changes. |
## ✨ What lucid does
lucid gives every agent in the project one shared memory, the dream, kept as plain files in .lucid/:
| File | What it holds |
| plan.md | The live plan. When anyone edits it, every running agent gets the diff before its next tool call. |
| log.jsonl | An append-only memory: decisions (with why), facts (with path:line evidence), dead ends, blockers and file claims. |
| digest.md | A consolidated summary, written when you run /lucid:dream. |
The memory is wired in through hooks, so agents can't forget to check it. Agents only add to the log and never rewrite it. A fact whose cited code has changed is flagged ⚠stale, so shared memory doesn't spread outdated claims.
## 🔭 How it works
| Hook | What it does |
| SessionStart (also after /compact) · SubagentStart | Injects the plan, the live memory and active claims, within a fixed budget. Subagents and Agent-Teams teammates start with the full shared context instead of a one-paragraph brief. |
| UserPromptSubmit · PreToolUse | Injects only what other agents wrote since you last looked. When nothing changed it injects nothing and costs no tokens. |
| PreToolUse on edits | 🔒 Blocks a write to a file another active agent has claimed, whether it goes through Edit/Write or through Bash (>, sed -i, cp/mv, scripts that open(…, 'w')). |
| PreToolUse on Bash | Adds the calling agent's real id to every lucid command, so every entry records who wrote it and agents never have to manage ids. |
| SubagentStop · TaskCompleted | Asks once for notes from an agent that edited files but logged nothing. A stopping subagent's claims are released. |
| Stop · SessionEnd | Releases a session's claims when its turn or the session ends, so an idle agent never blocks others. |
| UserPromptSubmit while workers are busy | Reminds the lead to write a chat change of plan into plan.md first, so running workers get it and it survives /compact. |
> lucid stays inactive until a project opts in with lucid init. In every other project a tiny shell guard checks for .lucid/ and exits without starting Python. It works from repo subfolders and git worktrees, which share the main checkout's dream.
## 📊 Benchmark
A live plan, an evidence-backed memory and file claims shared by the lead agent, its subagents and Agent-Teams teammates.
Change the plan partway through and every running worker sees the change before its next action.
Install ·
How it works ·
Benchmark ·
Commands ·
Real run ·
Limits
## 🌙 The problem
You build a feature with several Claude agents working at once, then change your mind partway through. Things go wrong:
| Symptom | Why it happens |
| 🧭 Plan drift | Workers that are already running still follow the plan they were spawned with. Nothing tells them it changed. |
| 📉 Lossy handoffs | A subagent's summary leaves out the why, and leaves out the "we tried X, it broke". |
| 🔁 Repeated work | Every worker re-reads and re-searches the same code. |
| 🫥 Compaction amnesia | Decisions disappear when the conversation is compacted and in new sessions. |
| 💥 Overwritten work | Two agents edit the same file and one loses its changes. |
## ✨ What lucid does
lucid gives every agent in the project one shared memory, the dream, kept as plain files in .lucid/:
| File | What it holds |
| plan.md | The live plan. When anyone edits it, every running agent gets the diff before its next tool call. |
| log.jsonl | An append-only memory: decisions (with why), facts (with path:line evidence), dead ends, blockers and file claims. |
| digest.md | A consolidated summary, written when you run /lucid:dream. |
The memory is wired in through hooks, so agents can't forget to check it. Agents only add to the log and never rewrite it. A fact whose cited code has changed is flagged ⚠stale, so shared memory doesn't spread outdated claims.
## 🔭 How it works
| Hook | What it does |
| SessionStart (also after /compact) · SubagentStart | Injects the plan, the live memory and active claims, within a fixed budget. Subagents and Agent-Teams teammates start with the full shared context instead of a one-paragraph brief. |
| UserPromptSubmit · PreToolUse | Injects only what other agents wrote since you last looked. When nothing changed it injects nothing and costs no tokens. |
| PreToolUse on edits | 🔒 Blocks a write to a file another active agent has claimed, whether it goes through Edit/Write or through Bash (>, sed -i, cp/mv, scripts that open(…, 'w')). |
| PreToolUse on Bash | Adds the calling agent's real id to every lucid command, so every entry records who wrote it and agents never have to manage ids. |
| SubagentStop · TaskCompleted | Asks once for notes from an agent that edited files but logged nothing. A stopping subagent's claims are released. |
| Stop · SessionEnd | Releases a session's claims when its turn or the session ends, so an idle agent never blocks others. |
| UserPromptSubmit while workers are busy | Reminds the lead to write a chat change of plan into plan.md first, so running workers get it and it survives /compact. |
> lucid stays inactive until a project opts in with lucid init. In every other project a tiny shell guard checks for .lucid/ and exits without starting Python. It works from repo subfolders and git worktrees, which share the main checkout's dream.
## 📊 Benchmark
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/redskull-127-lucid/)
- Source
- github · https://github.com/Redskull-127/lucid
- Browse by field
- Open source
- Listed by
- 2 independent sources
- added
- today
More entries
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.