Project Butler

project-butler

English | 中文
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:

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:

Open any project and set up project memory:

Work normally. At the end of a work session:

Next time, resume without re-explaining the project:

That is enough for daily use. For Cursor, Codex, and other assistants, see Tool Compatibility.

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 Code asks you once — and at
most once every 24 hours:

Picking Update now runs a fast-forward-only git pull for you and
reports the result. If it fails (local changes, offline, SSH blocked),
you get the manual command plus an HTTPS fallback. Nothing is ever
pulled without you choosing it.

The prompt is worded in your project's CLAUDE.md Language: setting
(English / Chinese / bilingual), and stops appearing once you are up to
date — the cache is keyed on commit SHA, not just time.

Side effect on git status: after the auto-fetch, git status
inside the skill directory may show "behind origin/main by N commits".
This is expected and harmless — the skill never modifies the working
tree unless you pick "Update now".

Silencing: export PROJECT_BUTLER_NO_UPDATE_CHECK=1. Only…