Buffer

Buf와 대화하고, 코딩 작업을 지휘하고, 프로젝트를 관리하는 AI 오케스트레이터입니다.

---

Buf가 할 수 있는 일

대화 — 토큰 스트리밍으로 실시간 응답합니다. 대화가 길어지면 핵심을 자동 요약해 맥락을 유지하고, 프로젝트별로 대화를 분리해 관리합니다.

코딩 작업 지휘 — 채팅으로 지시하면 격리된 git worktree에서 작업 → 테스트 자동 실행 → Merge/Discard 결재까지 진행합니다. 여러 프로젝트를 동시에 운용하고, 그룹으로 묶어 일괄 병합할 수 있습니다.

프로젝트 컨텍스트 — 프로젝트마다 CLAUDE.md를 앱 안에서 편집해 규칙·구조·주의사항을 등록합니다. Buf는 항상 이 파일을 참고해 작업합니다.

안전장치 — git push, rm -rf, 패키지 설치 등 위험 명령이 감지되면 실행을 멈추고 승인을 기다립니다.

설정 — Claude CLI 경로, 테마(라이트/다크/시스템), 폰트 크기를 앱 안에서 조절합니다.

---

설치

사전 준비

Claude Code CLI가 설치되어 있어야 합니다.

npm install -g @anthropic-ai/claude-code

설치 후 인증 토큰을 발급받습니다.

claude setup-token

발급된 토큰을 프로젝트 루트의 .env 파일에 저장합니다.

CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-...

설치본 다운로드 (준비 중)

추후 제공 예정

소스 빌드

Node.js 20+ 와 Git이 필요합니다.

git clone https://github.com/ssumanlife/buffer-app.git
cd buffer-app
pnpm install
pnpm dev        # 개발 실행
pnpm build:mac  # macOS 설치본 생성
pnpm build:win  # Windows 설치본 생성

---

주요 기능

대화 (Chat)

• Buf와 자연어로 대화하며 질문·요청·아이디어를 주고받습니다.
• 프로젝트를 선택하면 해당 프로젝트 경로에서 대화가 이루어집니다.
• 대화가 길어지면 오래된 내용을 자동으로 요약해 토큰을 절약합니다.

코딩 태스크 (Tasks)

• 자연어로 작업을 설명하면 Buf가 Claude Code를 실행해 코드를 수정합니다.
• 각 태스크는 독립된 git worktree에서 실행되어 현재 작업에 영향을 주지 않습니다.
• 완료 후 테스트가 자동으로 실행되고 결과를 표시합니다.
• Merge 또는 Discard로 변경사항을 최종 결정합니다.
• 여러 태스크를 그룹으로 묶어 한 번에 일괄 병합할 수 있습니다.

위험 명령 승인 큐

• 태스크 설명에서 위험한 작업(git push, rm -rf, 패키지 설치 등)이 감지되면 실행 전에 승인 요청이 표시됩니다.
• 승인하거나 취소할 수 있습니다.

프로젝트 관리

• 로컬 디렉토리를 프로젝트로 등록해 대화와 태스크를 분리합니다.
• 각 프로젝트의 CLAUDE.md 파일을 앱 안에서 직접 편집합니다.

변경사항 뷰어

• 태스크 완료 후 수정된 파일 목록과 diff를 컬러로 확인합니다.

---

단축키

동작	단축키
CLAUDE.md 저장	Cmd + S
CLAUDE.md 닫기	Esc
채팅 전송	Enter
줄바꿈	Shift + Enter

---

환경

• 지원 OS: macOS · Windows
• 의존성: Claude Code CLI
• 데이터 저장 위치
  • macOS: ~/Library/Application Support/buffer-app/
  • Windows: %APPDATA%\buffer-app\

---

라이선스

MIT