JamesShi96/project-butler

Claude Code, Cursor 등 AI 코딩 어시스턴트가 세션 간 프로젝트 맥락을 기억하도록 돕는 프로젝트 메모리 매니저

설치형 도구맘대로 써도 됨 · MIT코딩 보조·CLI 에이전트Shell난이도
264+13이번 주0 찜
11포크0이슈

중간맛 분석

스택: Shell 스크립트 기반 AI 코딩 어시스턴트 확장. 난이도: 초급 유저도 설치 후 자연어 명령어로 사용 가능 (/project-butler, end session, continue, status). 즉시 사용: Claude Code의 스킬로 설치하면 바로 작동하며, Cursor·Codex 같은 다른 도구도 생성된 규칙 파일로 지원. 데모: 예시(docs/examples.md)에서 프로젝트 초기화→작업→세션 종료→재개까지의 완전한 워크플로우 제시.

이런 레포예요

이럴 때 쓰면 좋아요

  • Claude Code나 Cursor를 사용하는 중장기 프로젝트에서 매 세션마다 아키텍처와 결정 사항을 재설명하지 않기 위해
  • 팀이 여러 AI 어시스턴트(Claude Code, Cursor, Codex)를 전환하며 사용할 때 공유 문서로 맥락 유지
  • 파일 구조와 명명 규칙, 프로젝트 규칙이 자동으로 관리되어야 하는 장기 운영 프로젝트에서

핵심 기능

자동 세션 핸드오프 및 맥락 복구프로젝트 프로필 시스템으로 대규모 프로젝트 변경 제어Claude Code/Cursor/Codex 멀티 도구 호환성

대안 대비 차별점

프로젝트 프로필 시스템을 통해 단순 메모 관리를 넘어 프로젝트 규모와 문서 정책을 추적하고, Normal Close/Full Close 같은 경계 제어 메커니즘으로 AI 어시스턴트가 프로젝트 상태를 일관되게 유지하도록 설계된 유일한 도구.

준비물

  • Claude Code CLI (또는 Cursor/Codex)
  • jq (세션 복구 기능용)

바로 시작하기

  1. project-butler를 Claude Code 스킬로 설치
git clone https://github.com/JamesShi96/project-butler.git ~/.claude/skills/project-butler
  1. 프로젝트에서 프로젝트 메모리 설정
/project-butler

  1. 정상적으로 작업 수행

  2. 작업 세션 종료 시 진행 상황 저장

end session
  1. 다음 번에 세션 복구
continue

별 추이 · 7일

264+13 / 7일

활용성 · 따라 만들기 좋은가

샘플 점수 34/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2026년 생성

이 레포에 깃밥 배지 달기

[![깃밥](https://www.gitbap.com/badge/JamesShi96/project-butler.svg)](https://www.gitbap.com/r/JamesShi96/project-butler)

🔌 클로드에서 바로 써보기

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기