Project Butler

project-butler

**[English](README.md)** | [中文](README_zh.md)

[](https://github.com/JamesShi96/project-butler/stargazers) [](https://github.com/JamesShi96/project-butler/releases) [](LICENSE) [](docs/compatibility.md)

Make AI coding agents remember your project between sessions.

project-butler helps Claude Code, Cursor, Codex, and similar AI coding assistants behave like long-term project teammates instead of starting from scratch every session.

For normal use, you only need four actions:

/project-butler   Set up project memory
end session       Save progress and next steps
continue          Resume next time
status            Check where the project stands

For projects that need stronger product, architecture, roadmap, research, or eval alignment, project-butler can also create a Project Profile during setup and offer profile-aware Normal Close / Full Close behavior.

Quick Start

Install as a Claude Code skill:

git clone https://github.com/JamesShi96/project-butler.git ~/.claude/skills/project-butler

Open any project and set up project memory:

/project-butler

Work normally. At the end of a work session:

end session

Next time, resume without re-explaining the project:

continue

That is enough for daily use. For Cursor, Codex, and other assistants, see [Tool Compatibility](docs/compatibility.md).

Updating project-butler

The skill auto-checks for updates on every invocation. Once per day per machine, it runs `git fetch` against its own repo and compares local `HEAD` to `origin/main`. If behind, Claude Co