JamesShi7

Project Butler — AI skill for Claude Code

AI community

Project memory system for AI coding assistants (Claude Code, Cursor, Codex): session logs, project wiki, rules, TODOs, and handoff.

How to install Project Butler

This entry records only its repository, not the path inside it, so there is no exact command to give. Open JamesShi7/project-init and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Project Butler does

Project memory system for AI coding assistants (Claude Code, Cursor, Codex): session logs, project wiki, rules, TODOs, and handoff.

Alternatives in AI

Agent Rules Books — AGENTS.md rules / skills for AI coding agents: Codex, Cursor & Claude Code 2.6k ★
CLI Continues — resume any AI coding session in another tool — Claude Code, Copilot, Gemini, Codex, Cursor 1.5k ★
Memory Forge Rs — Stop resetting satisfying AI chats — edit the memory instead 474 ★

README

project-butler

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

[![GitHub stars](https://img.shields.io/github/stars/JamesShi96/project-butler?style=social)](https://github.com/JamesShi96/project-butler/stargazers) [![GitHub release](https://img.shields.io/github/v/release/JamesShi96/project-butler?display_name=tag)](https://github.com/JamesShi96/project-butler/releases) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![AI Coding Assistants](https://img.shields.io/badge/AI%20Coding%20Assistants-Claude%20Code%20%7C%20Cursor%20%7C%20Codex-6B46C1)](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