Dear User

AI 에이전트는 당신을 위해 일하지만, 당신과 얼마나 잘 협업하고 있나요?

Dear User는 Claude Code 설정을 감사하고 무엇을 수정해야 할지 정확히 알려주는 오픈 소스 도구입니다. 협업 점수를 매기고, 유출된 비밀 정보나 설정 충돌을 찾아내며, 시스템 상태를 확인합니다. 모든 작업은 로컬에서 이루어지며, Wrapped 카드를 명시적으로 공유하지 않는 한 데이터는 업로드되지 않습니다.

claude mcp add --scope user dearuser -- npx -y @poisedhq/dearuser-mcp@latest

그런 다음 Claude에게 물어보세요: "나와 Claude의 협업 상태를 분석해줘"

랜딩 페이지: dearuser.ai · 피드백: Claude에서 feedback 도구를 사용하거나 이슈를 남겨주세요.

기능

Dear User는 MCP 서버(Claude Code와 Claude Desktop이 사용하는 플러그인 시스템인 Model Context Protocol)입니다. 설치하면 에이전트가 호출할 수 있는 도구 세트로 나타납니다. GUI, 가입, 클라우드 계정이 필요 없습니다.

3가지 로컬 보고서, 1개의 공유 가능한 Wrapped 카드, 1개의 피드백 채널을 제공합니다:

추가 도우미: onboard(7단계 가이드 설정), history(재스캔 없이 추세 확인), help(메뉴), implement_recommendation, dismiss_recommendation, share_report(Wrapped 전용 업로드).

출시 하이라이트

• 공유 가능한 Wrapped — wrapped 실행 후 share_report를 실행하여 통계 카드에 대한 dearuser.ai/r/<token> URL을 얻습니다. 업로드 전 익명화 처리됩니다(경로는 기본 이름으로 축소, 이메일 제거, 비밀 정보 마스킹). Collab/security/health 보고서는 로컬에 유지됩니다. 비즈니스 컨텍스트가 포함될 수 있어 자동 공유하기에 안전하지 않기 때문입니다.

• 12개 카테고리 비밀 정보 스캐너 — OpenAI, Anthropic, GitHub, AWS, Stripe, Slack, Google, Supabase, Vercel, 개인 키, 일반 환경 비밀 정보, 베어러 토큰. CLAUDE.md / AGENTS.md, 메모리 파일, 스킬, 훅을 스캔합니다.

• AGENTS.md 기본 지원 — CLAUDE.md와 함께 일급 입력으로 지원합니다. Cursor, Codex, Aider, Cline, Zed 및 Linux Foundation 교차 도구 표준을 따르는 모든 도구에서 즉시 작동합니다. 같은 디렉토리에 두 파일이 모두 있나요? 병합하여 처리합니다.

• 의미론적 충돌 감지(신규) — 키워드를 공유하지 않더라도 서로 모순되는 규칙을 찾습니다. "자주 커밋"과 "커밋 전 확인"이 충돌하는 경우 플래그를 지정합니다.

• 현실에 기반한 점수 보정 — 두 가지 연구: substrate가 커밋된 988개의 공개 Claude Code 설정(중앙값 32/100, 최대 63)과 2,895개의 독립형 CLAUDE.md 파일(중앙값 18, 최대 60). substrate 코퍼스는 실시간 점수를 위한 비교 기준입니다. 두 연구 모두 research/calibration/에서 확인하세요.

설치

클라이언트당 하나의 명령어가 필요합니다. 전체 가이드: docs/install.md.

Claude Code (CLI)

claude mcp add --scope user dearuser -- npx -y @poisedhq/dearuser-mcp@latest

설치 후 Claude Code를 재시작하여 도구가 나타나도록 하세요.

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)에 추가하세요:

{
  "mcpServers": {
    "dearuser": {
      "command": "npx",
      "args": ["@poisedhq/dearuser-mcp"]
    }
  }
}

Cursor, Windsurf, Cline, Zed — docs/install.md를 참조하세요.

선택 사항: 슬래시 명령어를 설치하여(전체 목록은 명령어 참조) 문장으로 질문하는 대신 /dearuser-collab과 같이 입력할 수 있습니다:

npx -p @poisedhq/dearuser-mcp dearuser-install-skills

첫 5분 가이드

설치 후 클라이언트를 재시작하고 다음 순서대로 시도해보세요:

1. 기준 스캔:

   Run Dear User collab on this project

   페르소나(Vibe Coder / Senior Developer / Indie Hacker / Venture Studio / Team Lead), 7개 카테고리에 걸친 0-100점 점수, 3-10개의 구체적인 권장 사항을 얻게 됩니다.

2. 보안 점검:

   Run Dear User security

   에이전트 계약(CLAUDE.md 또는 AGENTS.md), 메모리, 스킬 및 훅에서 유출된 토큰, 인젝션 표면 및 규칙 충돌을 확인합니다.

3. 결과 공유 (선택 사항):

   Share my collab report

   dearuser.ai/r/<token> 링크를 반환합니다. 업로드 전 익명화됩니다. 어디에 붙여넣을지는 사용자가 선택합니다.

collab의 출력 예시:

Persona: Indie Hacker (87% confidence)
Score:   73 / 100

Top friction:
  • Quality Standards — no test-before-commit rule in CLAUDE.md
  • Memory Health    — 2 memory files haven't been touched in 90+ days
  • Communication    — no language preference stated (English vs Danish mixing)

Recommendations (3 shown, 5 total):
  1. Add a "Session start protocol" block to CLAUDE.md  (apply with: implement_recommendation)
  2. Rotate the OpenAI key leaked in ~/.claude/memory/api-notes.md
  3. Merge overlapping skills: deploy-check and ship-check share 80% of their rules

명령어

Dear User와 함께 8개의 슬래시 명령어가 제공됩니다. 에이전트에게 이름으로 물어보거나, dearuser-install-skills로 설치했다면 슬래시 명령어를 입력하세요.

에이전트가 대신 호출할 수 있는 3가지 채팅 내 작업: share_report(Wrapped 카드를 dearuser.ai/r/<token>에 업로드), implement_recommendation(보류 중인 권장 사항 적용), dismiss_recommendation(관련 없는 것으로 표시).

개인정보 보호

Dear User는 로컬 우선입니다. 스캔 결과는 기기에 유지됩니다:

• 에이전트 계약(CLAUDE.md 또는 AGENTS.md), 메모리, 스킬, 훅 및 세션 메타데이터는 읽기만 하며 절대 업로드되지 않습니다.

• 결과는 ~/.dearuser/dearuser.db(SQLite, WAL 모드)에 저장됩니다.

• 선택적인 로컬호스트 대시보드는 해당 DB에서 읽어오며, 아무것도 전송되지 않습니다.

• Dear User는 세션 메타데이터만(카운트, 길이) 읽으며, 실제 대화 내용은 절대 읽지 않습니다.

• API 키가 필요 없고, 가입이 필요 없으며, 텔레메트리가 없습니다.

유일한 예외는 사용자가 명시적으로 트리거하는 경우입니다:

• share_report (Wrapped 전용) — Wrapped 카드는 익명화(경로 축소, 이메일 제거, 비밀 정보 패턴과 일치하는 모든 항목 마스킹)되어 dearuser.ai에 업로드되므로 URL을 공유할 수 있습니다. 로컬 DB는 수정되지 않습니다. expires_at을 설정하여 링크를 자동으로 만료시킬 수 있습니다. Collab/security/health 보고서는 공유할 수 없습니다. 비즈니스 컨텍스트(프로젝트 이름, 클라이언트 이름, 아키텍처 메모)가 포함될 수 있어 공개 URL에 두어서는 안 된다고 판단하기 때문입니다.

• feedback — 피드백 도구를 호출하면 메시지가 Supabase 받은 편지함으로 전송됩니다. 이것이 도구의 목적입니다. 스캔 결과나 파일을 첨부하지 않으며, 작성한 텍스트만 전송됩니다.

다른 도구는 아무것도 전송하지 않습니다. share_report가 DEARUSER_SUPABASE_URL + DEARUSER_SUPABASE_SERVICE_KEY로 구성되지 않은 경우, 깔끔하게 오류가 발생하며 Dear User의 나머지 기능은 계속 작동합니다.

전체 개인정보 보호 세부 정보: docs/privacy.md.

작동 원리

Your files (CLAUDE.md or AGENTS.md, memory, hooks, skills, sessions)
        │
    Scanner ──► Parser ──► Engines (scoring, secrets, conflicts, health)
        │
 Persona detection → Scoring → Gap analysis → Recommendations
        │
    Feedback loop (tracks which recommendations you implemented)
        │
    ~/.dearuser/dearuser.db  ←  dashboard reads from here

• 설정에서 감지된 5가지 페르소나 — 각각 맞춤형 권장 사항 제공

• 7가지 점수 카테고리: 역할 명확성, 커뮤니케이션, 자율성 균형, 품질 표준, 메모리 상태, 시스템 성숙도, 커버리지

• 피드백 루프: Dear User는 권장 사항을 기억합니다. 다음 실행 시, 사용자가 무엇을 구현했는지 확인하고 점수 변화를 보여줍니다.

대상 사용자

• "Vibe coders" — Claude에게 프롬프트를 입력하고 제품을 출시하지만, 설정이 실제로 잘 작동하는지 확신이 없는 분들. Dear User가 알려줍니다.

• 시니어 개발자 — 사용자 지정 린트 파이프라인을 구축하지 않고도 유출된 비밀 정보, 설정 드리프트, 규칙 충돌에 대한 빠른 감사를 원하는 분들.

• 인디 해커 / 1인 창업자 — 프로젝트 전반에 걸쳐 훅, 스킬, 메모리가 쌓여 있는 분들. Dear User가 고아 상태이거나 서로 모순되는 항목을 찾아냅니다.

• 팀 리더 — 팀의 공유 에이전트 설정을 로컬에서 감사하고 싶은 분들. Collab, 보안 및 상태 보고서는 기기에 유지되며, 개인 Wrapped 카드만 공개적으로 공유할 수 있습니다.

저장소 구조

• mcp/ — @poisedhq/dearuser-mcp npm 패키지(MCP 서버). 개발 노트는 mcp/README.md 참조.

• web/ — dearuser.ai 랜딩 + 공유 보고서 페이지(Astro).

• docs/ — 설치 가이드, 개인정보 보호 문서, 플랫폼별 설정(선택적 security 플랫폼 어드바이저를 위한 Supabase/GitHub/Vercel).

• research/ — 보정 데이터 + 공유 가능한 아키텍처 노트.

기여

CONTRIBUTING.md를 참조하세요. 버그 리포트와 작은 수정 사항은 GitHub 이슈와 PR을 통해 환영합니다.

커뮤니티 및 지원

• GitHub Discussions — 질문, 아이디어, "어떻게 하나요?", 쇼앤텔

• GitHub Issues — 재현 가능한 버그 및 기능 요청

• 피드백 받은 편지함 — 비공개 메모; 또는 Claude 내부에서 feedback MCP 도구 사용

링크

• dearuser.ai — 랜딩 페이지

• 설치 가이드 · 개인정보 보호 · 플랫폼 어드바이저 설정

라이선스

Dear User는 MIT 라이선스를 따릅니다. LICENSE를 참조하세요.

오픈 코어 약속: 이 저장소의 모든 것은 MIT이며 앞으로도 MIT로 유지됩니다. 팀 기능이나 호스팅 기능(에이전시 대시보드, 프로젝트 간 추세선, 수직별 벤치마크)을 구축하더라도, 이 저장소에서 코드를 가져오는 방식이 아니라 별도의 저장소와 자체 라이선스로 운영될 것입니다.