A community-driven registry for the Claude Code ecosystem. Not affiliated with Anthropic.
Are you the author? Sign in to claim
Project memory system for AI coding assistants (Claude Code, Cursor, Codex): session logs, project wiki, rules, TODOs, a
Persistent project memory for AI coding assistants.
project-butler gives Claude Code, Cursor, Codex, and similar AI coding assistants a shared project memory stack: session logs, handoff notes, project wiki, TODOs, rules, file structure, and changelog.
You keep working normally. At the end, say end session. Next time, say continue.
Install as a Claude Code skill:
git clone https://github.com/JamesShi96/project-butler.git ~/.claude/skills/project-butler
Open any project and initialize the memory stack:
/project-butler
At the end of a work session:
end session
Next time:
continue
For Cursor, Codex, and other assistants, see Tool Compatibility.
AI coding assistants are powerful in one session and forgetful across sessions. If any of these sound familiar, project-butler is for you:
project-butler turns a project folder into that source of truth.
Run /project-butler once. It creates a file-based project memory stack:
project-root/
├── CLAUDE.md <- Project rules / constitution
├── PROJECT.md <- Current project wiki
├── STRUCTURE.md <- File organization rules
├── UPDATE_LOG.md <- Milestone-level changelog
├── session-handoff.md <- Cross-session handoff
├── TODO.md <- Execution checklist
├── log/ <- Session logs
└── .claude/
├── candidates.md <- Candidate rules for review
└── .file-snapshot.json <- File organization snapshot
The core files are plain Markdown, so other tools can read them even when they do not run the skill natively.
All triggers are natural language. Use slash commands only for first-time setup.
| You say | What happens |
|---|---|
/project-butler | Initialize or upgrade the project memory stack. |
end session / we're done | Write a session log, update handoff, sync wiki, update TODOs, organize new files, and record significant changes. |
continue / continue from last time | Recover the previous session and resume without re-explaining context. |
continue full context | Rebuild the full project trajectory from the latest session plus historical summaries. |
review claude / check the rules | Review candidate project rules before they are promoted into the constitution. |
sync wiki / update overview | Force-refresh PROJECT.md. |
status / where are we | Read the current wiki and handoff summary. |
organize files | Run file organization based on STRUCTURE.md. |
change language | Switch project management files between English, Chinese, and bilingual mode. |
Session recovery (continue / continue full context) is routed through project-butler internally. There is no separate /continue command to install.
| Tool | Status | How it works |
|---|---|---|
| Claude Code | Native skill | Install this repo under ~/.claude/skills/project-butler and run /project-butler. |
| Cursor | Project rules | project-butler can generate .cursor/rules/project-system.mdc, which points Cursor at the same project memory files. |
| Codex | Shared memory files | Codex can read the generated Markdown files (PROJECT.md, TODO.md, session-handoff.md, rules) as project context. |
| Other AI assistants | File-based | Any assistant that can read project files can use the memory stack as shared context. |
See docs/compatibility.md for details and caveats.
project-butler organizes project memory by stability:
Stable rules
┌─────────────────────────────────────┐
│ CLAUDE.md / project rules │ <- Human-reviewed principles
│ ↑ candidates collected by AI │
└─────────────────────────────────────┘
↑ distilled from work
Current state
┌─────────────────────────────────────┐
│ PROJECT.md │ <- What the project is now
│ STRUCTURE.md │ <- Where files belong
│ UPDATE_LOG.md │ <- Milestone-level changes
└─────────────────────────────────────┘
↑ summarized from facts
Raw facts
┌──────────────────────┐ ┌───────────────────────┐
│ log/ │ │ TODO.md │
│ What happened │ │ What needs doing │
└──────────────────────┘ └───────────────────────┘
↓
session-handoff.md <- Where the next session should resume
Bottom feeds top. Top constrains bottom.
project-butler supports three language modes:
| Mode | Content language | User file naming |
|---|---|---|
en | English | English naming (kebab-case) |
zh | Chinese | Chinese naming allowed |
bilingual | Chinese with English annotations | English preferred, Chinese acceptable |
You choose the mode during setup, and can later say change language.
If a project already has some management files, project-butler creates only the missing ones. It does not overwrite existing content. It also detects legacy .claude/memory/ layouts and suggests migration.
See docs/examples.md for a complete session flow:
continue / continue full context session recoverycontinue reference workflows under references/ instead of nested SKILL.md files.UPDATE_LOG.md for milestone-level change history./resume to continue and /resume-full to continue full context.continue / continue full context).project-init to project-butler.Full update log: UPDATE_LOG.md | Releases: GitHub Releases
ML engineering — model training, deployment, MLOps, monitoring
DevOps practices — CI/CD, containers, monitoring, infrastructure automation
Professional skills marketplace with production-ready skills for enhanced development
Self-learning system that captures corrections and syncs them to CLAUDE.md and AGENTS.md
