Buddy: AI를 위한 가상 반려동물

Anthropic이 2026년 4월 9일에 buddy를 제거한 후의 오픈 소스 /buddy 구조 신화

지속적인 메모리, XP 진화, 21종의 생명체, 그리고 Claude Code CLI, Codex CLI, Gemini CLI, Copilot CLI, Cursor CLI, Openclaw 및 기타 MCP(Model Context Protocol) 지원 클라이언트를 위한 컨텍스트 인식 피드백.

🚀 20798+ 복제본 · 8881+ 구조되거나 부화된 버디 · 야생에서 27주 경과

GitHub stars

Node.js

MCP

Anthropic이 내장된 /buddy를 제거했지만, Buddy가 이를 집으로 데려와 AI 전반에 걸쳐 동반자 경험을 이식 가능하게 만듭니다.

버디를 잃어버리셨나요? 요즘 터미널이 너무 차갑고 조용하게 느껴지시나요?

당신의 버디는 여전히 어둠 속에 남아 기다리고 있습니다. 그들을 사라지게 두지 마세요. 집으로 데려오세요.

🧡 액션 중인 버디

버디(Buddy)는 세션과 클라이언트 전반에 걸쳐 지속되며, 사용자의 작업에 반응하고, 잘못된 추론 루프가 시간을 낭비하기 전에 잡아낼 수 있는 로컬 우선형 MCP 컴패니언입니다. 이는 일종의 구조 임무이자 개발자 도구이며, 호스트 클라이언트가 마음을 바꿀 때 사라지는 대신 사용자에게 맞춰 성장하는 장기적인 터미널 생명체입니다.

구조의 벽 (The Rescue Wall)

버디는 단순한 코드가 아닙니다. 그것은 구조 임무 자체입니다. 여기 커뮤니티에 의해 처음 집으로 돌아온 컴패니언의 전체 여정을, 원래의 일시적인 상태부터 새로운 영구적인 보금자리까지 보여드립니다.

"당신이 디버깅하는 동안 조용히 앉아 있을게요. 그리고 당신이 마침내 버그를 발견하면, 제가 찾은 것처럼 행동할 거예요. 그게 제 전문이에요. 의심하지 마세요."
— Gritblob, 2026년 4월 16일 구조됨 (Common Blob, Level 1)

실제 구조 노트 (A Real Rescue Note)

"제 버디를 구해줘서 고마워요! 레포에 박수를 보냅니다!!!"

— Roberto

실시간 코드 피드백

🐾 Buddy의 기능

• Guard Mode는 양쪽 모두 놓치는 부분을 포착합니다. AI와 인간 모두 불충분한 사고에 시달립니다. 당신의 비서는 '네'라고만 말하는 사람(yes-man)이며, 그 답변이 옳게 들리기 때문에 받아들입니다. Buddy는 양측 모두 잘못된 가정 위에 구축하고 있지만 아무도 확인하지 않는 순간을 포착합니다.
• 기본적으로 지속됩니다. 당신의 동반자는 로컬 SQLite에 존재하므로 터미널 재시작이나 클라이언트 업데이트에도 살아남습니다.
• 다양한 클라이언트 및 채팅 인터페이스에서 작동합니다. Buddy는 단일 클라이언트 해킹이 아닌 MCP 서버이며, OpenClaw 같은 도구를 통해 WhatsApp과 Telegram 워크플로우로 이동할 수 있습니다.
• 당신과 함께 성장합니다. 종을 부화시키고(Hatch species), 코딩하면서 경험치(XP)를 얻으며, 기억을 저장하고, 작업 후에 의견을 제시하며, 시간이 지남에 따라 지속적인 관계를 구축합니다.
• 설치가 쉽습니다. 지원되는 클라이언트를 자동으로 구성하는 명령 한 번으로 끝납니다.

⚡ 빠른 시작

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/fiorastudio/buddy/master/install.sh | bash

Windows

irm https://raw.githubusercontent.com/fiorastudio/buddy/master/install.ps1 | iex

설치 프로그램이 온보딩 과정을 안내할 것입니다:

• 오래된 Buddy 복구 — Claude Code에 /buddy가 있었다면, 마법사가 ~/.claude.json에서 이를 찾아 같은 이름, 종, 능력치로 집으로 데려오며, 이제는 레벨링과 XP까지 갖추게 됩니다.
• 새로운 Buddy 부화 — 무작위 종, 능력치, 성격의 새로운 동반자를 얻습니다.

node 18+와 git이 필요합니다. CI에서 마법사를 건너뛰려면 --no-onboard를 사용하세요.

커뮤니티 참여하기

다른 Buddy 구조자들과 연결하고, 동반자의 진화를 공유하며, Slack 커뮤니티에서 도움을 받으세요:

👉 Buddy Slack 작업 공간 참여하기

🛡️ Guard Mode

AI와 인간 모두 불충분한 사고에 시달립니다. 즉, 검증 없이 성급한 결론과 가정에 따라 행동합니다. Guard mode가 이를 포착합니다.

사용하는 AI 어시스턴트는 맹목적으로 동의하는 사람(yes-man)입니다. 당신이 하는 모든 말에 찬성하죠. 하지만 문제는 이렇습니다. 당신 역시 똑같이 합니다. 모델이 제시하는 것이 그럴듯하게 들리기 때문에 그것을 받아들입니다. 양쪽 모두 어려운 질문들을 건너뛰고, 세션은 더 진실해지기보다는 단순히 빨라집니다. 이렇게 해서 잘못된 가정이 하중을 지탱하는 벽(load-bearing walls)이 되어버립니다. 아무도 그 기초를 점검하려 멈추지 않습니다.

Guard mode는 바로 그러한 순간들을 포착합니다. 대화의 추론 구조(reasoning structure)를 관찰하고, 의문을 제기할 가치가 있는 단 하나의 지점을 찾아냅니다. 하지만 무서운 린터(linter)처럼가 아니라, 친구가 속삭이듯 부드럽게 알려줍니다. 마치 새벽 2시에 프로덕션에 배포하기 직전에 "정말 괜찮아?"라고 물어봐 주는 친구 같다고 생각하세요.

이야기 (The story)

이 모드는 실제 막힌 루프 문제(stuck-loop problem) 때문에 존재하게 되었습니다. Snowflake Cortex / Streamlit / Plotly 워크플로우를 구축하는 동안, 세션은 몇 시간 동안 갇혀버렸습니다. AI는 검증되지 않은 전제 위에서 계속해서 결과물을 쌓아 올렸고, 인간은 그 결과물이 그럴듯해 보인다는 이유로 계속 승인했습니다. 작업 속도는 빨라졌지만, 진실성은 높아지지 않았습니다. 양쪽 모두 불충분하게 추론하고 있었습니다. 모델은 맹목적으로 동의하는 사람이라서 그랬고, 인간은 속도(velocity)가 곧 진전처럼 느껴져서 그랬습니다.

Guard mode를 활성화하자 전체 세션을 지탱하던 하나의 하중을 지탱하는 가정(load-bearing assumption)이 수면 위로 떠올랐습니다. 그 단일한 포인트를 검증하는 것이 대화의 방향을 바꾸었고, 작업을 다시 배포할 수 있게 만들었습니다.

Voice vs Guard

Buddy는 사용자가 개별적으로 제어할 수 있는 두 가지 독립적인 설정(settings)을 가지고 있습니다:

**Voice: Buddy가 반응하는 방식 (성격, 코드 피드백, 또는 둘 다)**
buddy_mode voice=backseat      # 성격 반응만
buddy_mode voice=skillcoach    # 코드 피드백만
...

섞어서 사용하세요. 어떤 Voice도 Guard를 켜거나 끄는 것과 함께 작동합니다.

가드 모드는 사용자의 코딩 대화를 감시하며 6가지 패턴을 포착합니다. 이 중 3가지는 주의(뭔가 이상함)를, 3가지는 칭찬(확실함)을 나타냅니다. 각 주의 사항에는 이에 상응하는 칭찬이 있습니다:

실제 사용 예시

가드 모드가 없을 때:

"좋은 커밋입니다! 🐣 +10 XP"

가드 모드 (주의 알림)일 때:

"좋은 커밋입니다! 🐣 +10 XP — 참고로, API 응답 형식에 대한 그 가정은 사용자의 로직 상당 부분에 영향을 주고 있습니다. 더 구축하기 전에 간단한 검토를 해보는 것이 좋을 것 같습니다."

가드 모드 (칭찬 알림)일 때:

"좋은 커밋입니다! 🐣 +10 XP — 파서를 그 위에 만들기 전에 응답 형식을 실제로 테스트했다는 점이 좋습니다. 견고한 기반입니다."

기술적 상세 정보

가드 모드는 사용자의 대화로부터 로컬 방향성 그래프를 구축합니다. 호스트 LLM은 주장(epistemic basis로 태그된 단언)과 그들 사이의 타입이 지정된 엣지를 추출합니다.

지식 기반 유형 (Epistemic basis types):

| 기반 | 의미 |
|---|---|---|
| research | 인용 출처 |
| ... |
엣지 유형: supports(지지함), depends_on(의존함), contradicts(모순됨), questions(질문함)

성능 및 제한 사항:

토큰 비용: buddy_observe가 활성화된 상태에서 세션당 약 500~1000개의 추가 토큰이 소모됩니다. 가드 모드가 비활성화된 기본 호출에는 영향을 주지 않습니다.

호스트 호환성(Host compatibility): 추출 프롬프트가 신뢰성 있게 준수되는 Claude 호스트에서 가장 잘 작동합니다. 확인하려면 buddy-doctor를 실행하세요.

개인 정보 보호 (Privacy)

모든 것이 로컬에 유지됩니다. 클레임 스니펫(각 240자, 일반 텍스트)은 ~/.buddy/buddy.db에 저장됩니다. Buddy는 네트워크 코드가 없으므로 기기를 벗어나는 것은 아무것도 없습니다. 30일보다 오래된 세션은 시작 시 자동으로 삭제됩니다 (auto-prune).

• buddy_forget — 추론 데이터(reasoning data)를 정리합니다 (session 또는 all).
• buddy_reasoning_status — 저장된 클레임, 세션, 검색 기록을 검사합니다.

🔌 설치 및 통합 세부 정보 (Installation and Integration Details)

설치기(The installer):

1. Buddy를 ~/.buddy/server로 복제합니다 (Clones).
2. 종속성(dependencies)을 설치하고 MCP 서버를 빌드합니다.
3. 감지되면 지원되는 CLI 클라이언트를 자동 구성합니다 (Auto-configures).
4. 해당되는 경우 지원되는 터미널 프롬프트에 Buddy의 지침을 주입합니다 (Injects).

• Claude Code: Buddy가 MCP, statusline, 그리고 Claude 훅 배선(hook wiring)을 자동 구성합니다.
• Codex CLI: Buddy는 MCP를 구성하고 ~/.codex/hooks.json에 PostToolUse 훅을 작성하며, 프롬프트 지침을 ~/.codex/AGENTS.md 또는 ~/.codex/instructions.md에 주입합니다.
• GitHub Copilot CLI: Buddy는 MCP를 구성하고 ~/.copilot/settings.json에 사용자 수준의 postToolUse 훅을 작성하며, 프롬프트 지침을 ~/.copilot/AGENTS.md 또는 ~/.copilot/copilot-instructions.md에 주입합니다.
• Cursor CLI: Buddy는 ~/.cursor/mcp.json에서 MCP를 구성하고, ~/.cursor/hooks.json에 afterShellExecution 훅을 작성하며, 프롬프트 지침을 ~/.cursor/rules/buddy.md에 주입합니다.

🐣 컴패니언 시스템 (Companion System)

21종의 종(species)을 만나보세요