Beads Task Memory
gastownhall/beads
Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.
Memory management system for Claude Code — Student Loop, Smart Context, Auto Learn, Session Handoff, Correction Cycle.
$ npx skills add HelloRuru/claude-memory-engine --skill memory-engine -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install HelloRuru/claude-memory-engine memory-engine --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/HelloRuru/claude-memory-engine.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skill .claude/skills/memory-engine && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "memory-engine" agent skill from https://github.com/HelloRuru/claude-memory-engine/tree/main/skill into .claude/skills/memory-engine/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "memory-engine", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/HelloRuru/claude-memory-engine/tree/main/skillType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add HelloRuru/claude-memory-engine --skill memory-engine -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install HelloRuru/claude-memory-engine memory-engine --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HelloRuru/claude-memory-engine.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skill .agents/skills/memory-engine && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "memory-engine" agent skill from https://github.com/HelloRuru/claude-memory-engine/tree/main/skill into .agents/skills/memory-engine/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "memory-engine", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HelloRuru/claude-memory-engine --skill memory-engine -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install HelloRuru/claude-memory-engine memory-engine --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HelloRuru/claude-memory-engine.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skill .cursor/skills/memory-engine && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "memory-engine" agent skill from https://github.com/HelloRuru/claude-memory-engine/tree/main/skill into .cursor/skills/memory-engine/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "memory-engine", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/HelloRuru/claude-memory-engine.git --path skill--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add HelloRuru/claude-memory-engine --skill memory-engine -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install HelloRuru/claude-memory-engine memory-engine --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HelloRuru/claude-memory-engine.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skill .gemini/skills/memory-engine && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "memory-engine" agent skill from https://github.com/HelloRuru/claude-memory-engine/tree/main/skill into .gemini/skills/memory-engine/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "memory-engine", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install HelloRuru/claude-memory-engine memory-engineInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add HelloRuru/claude-memory-engine --skill memory-engine -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/HelloRuru/claude-memory-engine.git skills-src && mkdir -p .github/skills && cp -r skills-src/skill .github/skills/memory-engine && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "memory-engine" agent skill from https://github.com/HelloRuru/claude-memory-engine/tree/main/skill into .github/skills/memory-engine/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "memory-engine", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HelloRuru/claude-memory-engine --skill memory-engine -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install HelloRuru/claude-memory-engine memory-engine --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HelloRuru/claude-memory-engine.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skill .opencode/skills/memory-engine && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "memory-engine" agent skill from https://github.com/HelloRuru/claude-memory-engine/tree/main/skill into .opencode/skills/memory-engine/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "memory-engine", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
memory-engineMemory management system for Claude Code — Student Loop, Smart Context, Auto Learn, Session Handoff, Correction Cycle.
Memory Engine is an agent skill from HelloRuru/claude-memory-engine. Memory management system for Claude Code — Student Loop, Smart Context, Auto Learn, Session Handoff, Correction Cycle. Triggered by memory commands (/save, /reflect, /handoff, /check) or memory-related questions. Not for general programming tasks.
Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/auto-learn.md` and `references/smart-context.md`).
It sits in Agent Workflows, covering Session handoff and Agent memory. The repository describes itself as: Claude Code 的記憶系統 | A memory system built with hooks + markdown. Zero dependencies. The licence is MIT.
5 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 04f085c. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
gitFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Memory Engine loads about 1.9k tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 804 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from HelloRuru/claude-memory-engine at commit 04f085c, republished under its MIT licence (© HelloRuru). 804 words, ~1,910 tokens.
.claude/skills/memory-engine/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.A memory and learning system for Claude Code, built with hooks and markdown.
Auto-detects the current project from your working directory and loads its memory.
~/.claude/scripts/hooks/session-start.jsreferences/smart-context.mdDetects pitfall patterns before context compression — retries, errors followed by fixes, user corrections.
~/.claude/skills/learned/shared-utils.js → detectPitfalls() + savePitfalls()8-step learning cycle. First 3 steps are automatic (every session). Last 5 via /reflect.
There is no real "end" to a Claude Code conversation. Memory Engine saves at three points:
mid-session-checkpoint) — most reliable, self-countedpre-compact) — pitfall detection runs here, context is fullestsession-end) — best-effort, not guaranteed to fireYou don't need to remember to run any command before closing. 4. Review — read past 7 days, mark useful vs outdated 5. Refine — 4-question decision tree (Keep? Condense? Already covered? Delete as last resort) 6. Re-study — re-analyze cleaned data for buried patterns 7. Slim down — list removable items, wait for user confirmation 8. Wrap up — produce a report
Pass context between Claude Code windows without losing progress.
/handoff saves a handoff-*.md file with progress, decisions, unfinished taskssession-start.js)memory-sync.js.handoff-read.jsonLearns from user corrections — mistakes that don't show up in error logs.
/analyze) — compare user's edits against rules, log missed rules, distill new ones/reflect step 6) — same mistake 3+ times → upgrade to hard rule| Hook | File | What it does |
|---|---|---|
| SessionStart | session-start.js | Load last summary + project memory + pending handoffs + pitfall review + /reflect reminder |
| SessionEnd | session-end.js | Save summary + project index + backup (best-effort, may not fire) |
| PreCompact | pre-compact.js | Snapshot + pitfall detection + backup — the real safety net |
| UserPromptSubmit | memory-sync.js | Cross-session memory change detection + handoff detection |
| UserPromptSubmit | mid-session-checkpoint.js | Checkpoint every 20 messages |
| PreToolUse(Write) | write-guard.js | Sensitive file write warning |
| PreToolUse(Bash) | pre-push-check.js | Safety check before git push |
| — | memory-backup.sh | Bidirectional sync script (push/pull/sync) — v1.6 |
Shared logic between session-end.js and pre-compact.js is extracted into shared-utils.js.
| EN | ZH | Function |
|---|---|---|
| /save | /存記憶 | Save memory — auto-dedup, route to correct file |
| /reload | /讀取 | Load memory into current conversation |
| /todo | /待辦 | Cross-project task tracking |
| /backup | /備份 | Push local memory to GitHub (memory-backup.sh push) |
| /sync | /同步 | Bidirectional sync (memory-backup.sh sync) — v1.6 pull+push |
| /handoff | /交接 | Session handoff — pass progress to next window |
| /diary | /回顧 | Generate reflection diary |
| /reflect | /反思 | Analyze pitfalls, find patterns |
| /learn | /學習 | Manually save a pitfall |
| /analyze | /分析 | Record corrections into error notebook |
| /correct | /訂正 | Review error notebook anytime |
| /check | /健檢 | Quick health scan |
| /full-check | /大健檢 | Full audit |
| /memory-health | /記憶健檢 | Memory file stats + capacity warnings |
| /memory-search | /搜尋記憶 | Keyword search across all memory files |
| /recover | /想起來 | Restore memory from GitHub (memory-backup.sh pull) — v1.6 auto-distribute |
| /compact-guide | /壓縮建議 | When to compact and when not to |
| /overview | /全覽 | List all available commands |
~/.claude/
scripts/hooks/
session-start.js # Load recall + smart-context + handoff
session-end.js # Save summary + backup (best-effort)
pre-compact.js # Pre-compression snapshot + pitfall detection + backup
shared-utils.js # Shared functions (transcript, pitfall, backup)
memory-sync.js # Cross-session sync + handoff detection
mid-session-checkpoint.js
write-guard.js
pre-push-check.js
memory-backup.sh # Bidirectional sync (push/pull/sync) — v1.6
sessions/
{date}-{id}-session.md # Session summaries
{date}-{id}-compact.md # Pre-compact snapshots
diary/ # Reflection diaries
commands/
save.md / 存記憶.md # ...15 pairs
handoff.md / 交接.md
skills/learned/memory-engine/
SKILL.md # This file
references/
smart-context.md # Project detection rules
auto-learn.md # Pitfall detection ruleswc -l before every write. Over 170 lines → move old content to standalone files firstmemory/*.mdgit pull first, resolve conflicts if anyprojects/ directoriespull and sync modes to memory-backup.sh. The pull distributes global memory files from the backup repo into every local project directory that has a memory/ folder (newer file wins, won't overwrite local changes)projects/ paths differ. Global memory must be actively distributed, not just stored in one placereferences/smart-context.md — Project detection rulesreferences/auto-learn.md — Pitfall detection rules + auto-learn flow© HelloRuru, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 2 other files (references) in skill of HelloRuru/claude-memory-engine.
Open the folder on GitHubat commit 04f085c
Memory Engine next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Memory Engine this skillHelloRuru/claude-memory-engine | 134 | — | ~1.9k | Automated safety check: Pass | MIT | |
| Beads Task Memorygastownhall/beads | 28k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Session History Searchslopus/happy | 24k | — | ~3.1k | Automated safety check: Pass | MIT | |
| Memori Long-Term MemoryMemoriLabs/Memori | 17k | — | ~2k | Automated safety check: Notes | Custom licence | |
| Coding Agent Session Findercode-yeongyu/oh-my-openagent | 70k | — | ~2.8k | Automated safety check: Pass | Custom licence | |
| Deja History Searchvshulcz/deja-vu | 1.1k | 1 repos | ~1.3k | Automated safety check: Pass | MIT |
gastownhall/beads
Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.
slopus/happy
Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.
MemoriLabs/Memori
Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward.
code-yeongyu/oh-my-openagent
Finds, reads and reconstructs past coding-agent sessions across Codex, Claude, OpenCode, Senpi and many other local agent logs.
vshulcz/deja-vu
Searches this machine's own history of past AI coding sessions across every tool used on it, before work is redone or something is denied.
MemoriLabs/Memori
Teaches an MCP-connected agent when and how to call Memori's recall, summary, compaction, augmentation, feedback and quota tools to keep context across sessions.
Categories
Memory management system for Claude Code — Student Loop, Smart Context, Auto Learn, Session Handoff, Correction Cycle. Memory Engine is an agent skill from HelloRuru/claude-memory-engine. Memory management system for Claude Code — Student Loop, Smart Context, Auto Learn, Session Handoff, Correction Cycle.
Memory Engine fits situations like: tasks that involve Session handoff; tasks that involve Agent memory.
Run `npx skills add HelloRuru/claude-memory-engine --skill memory-engine -a claude-code`. Or copy the skill folder (skill in HelloRuru/claude-memory-engine) into .claude/skills/memory-engine in your project. Claude Code loads it when a task matches its description.
Run `npx skills add HelloRuru/claude-memory-engine --skill memory-engine -a codex`. Or copy the skill folder (skill in HelloRuru/claude-memory-engine) into .agents/skills/memory-engine in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HelloRuru/claude-memory-engine --skill memory-engine -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/memory-engine, .gemini/skills/memory-engine, .github/skills/memory-engine and .opencode/skills/memory-engine in your project.
Going by SKILL.md and its folder, Memory Engine needs the command-line tools its instructions call (git).
SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Memory Engine is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.9k tokens (SKILL.md is roughly 7.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 503 tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Memory Engine: Beads Task Memory (gastownhall/beads, 28k stars), Session History Search (slopus/happy, 24k stars), Memori Long-Term Memory (MemoriLabs/Memori, 17k stars) and Coding Agent Session Finder (code-yeongyu/oh-my-openagent, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
HelloRuru (a GitHub user) maintains it in HelloRuru/claude-memory-engine, which has 134 GitHub stars. The repository was last updated on May 11, 2026.
Source: HelloRuru/claude-memory-engine on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.