Уважаемый пользователь

Ваш ИИ-агент работает на вас — но насколько хорошо вы работаете вместе?

Dear User — это инструмент с открытым исходным кодом, который проводит аудит вашей настройки Claude Code и точно говорит, что нужно исправить. Он оценивает ваше сотрудничество, находит утечки секретов и конфликты конфигурации, а также проверяет состояние системы — всё локально, ничего не загружается, если вы явно не поделитесь своей карточкой Wrapped.

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

Затем спросите Claude: "Проанализируй мое сотрудничество с Claude"

Сайт: dearuser.ai · Обратная связь: используйте инструмент feedback в Claude или откройте issue

Что он делает

Dear User — это MCP-сервер (Model Context Protocol — система плагинов, которую используют Claude Code и Claude Desktop). После установки он отображается как набор инструментов, которые может вызывать ваш агент. Никакого графического интерфейса, никакой регистрации, никакой облачной учетной записи.

Три локальных отчета, одна карточка Wrapped, которой можно поделиться, и один канал обратной связи:

Плюс помощники: onboard (пошаговая настройка из 7 этапов), history (тренды без повторного сканирования), help (меню), implement_recommendation, dismiss_recommendation, share_report (загрузка только для Wrapped).

Основные моменты запуска

• Карточка Wrapped, которой можно поделиться — запустите wrapped, затем share_report, чтобы получить URL dearuser.ai/r/<token> для вашей карточки статистики. Анонимизируется перед загрузкой (пути сокращаются до имен файлов, email удаляются, секреты скрываются). Отчеты Collab/security/health остаются локальными — выводы могут содержать бизнес-контекст, который небезопасно автоматически публиковать.

• Сканер секретов по 12 категориям — OpenAI, Anthropic, GitHub, AWS, Stripe, Slack, Google, Supabase, Vercel, приватные ключи, общие секреты окружения, bearer-токены. Сканирует CLAUDE.md / AGENTS.md, файлы памяти, навыки, хуки.

• Нативная поддержка AGENTS.md — первоклассный ввод наряду с CLAUDE.md. Работает «из коробки» для Cursor, Codex, Aider, Cline, Zed и всех, кто следует стандарту Linux Foundation для кросс-инструментальных агентов. Оба файла в одной директории? Мы объединяем их.

• Семантическое обнаружение конфликтов (новое) — находит правила, которые противоречат друг другу, даже если у них нет общих ключевых слов. Например, «коммить часто» против «спрашивай перед коммитом» будет помечено.

• Оценка, откалиброванная по реальности — два исследования: 988 публичных настроек Claude Code с зафиксированным субстратом (медиана 32/100, макс. 63) и 2 895 отдельных файлов CLAUDE.md (медиана 18, макс. 60). Корпус субстрата — это эталон для сравнения «яблок с яблоками» для живых оценок. См. 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), оценку от 0 до 100 по 7 категориям и 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. Спрашивайте своего агента по имени или вводите слэш-команду, если вы установили их с помощью dearuser-install-skills.

Три действия в чате, которые агент может вызвать за вас: share_report (загрузить карточку Wrapped на dearuser.ai/r/<token>), implement_recommendation (применить ожидающую рекомендацию), dismiss_recommendation (отметить как неактуальную).

Конфиденциальность

Dear User ориентирован на локальную работу. Ваши сканы остаются на вашем компьютере:

• Контракт вашего агента (CLAUDE.md или AGENTS.md), память, навыки, хуки и метаданные сессии считываются, но никогда не загружаются

• Результаты хранятся в ~/.dearuser/dearuser.db (SQLite, режим WAL)

• Опциональная локальная панель управления считывает данные из этой БД — ничего не передается

• Dear User считывает только метаданные сессии (количество, длительность) — никогда не считывает содержание вашего разговора

• API-ключи не требуются, регистрация не нужна, телеметрия отсутствует

Единственные исключения — это действия, которые вы инициируете явно:

• share_report (только для Wrapped) — ваша карточка Wrapped анонимизируется (пути сокращаются, email удаляются, всё, что соответствует нашим паттернам секретов, скрывается) и загружается на dearuser.ai, чтобы вы могли поделиться URL. Ваша локальная БД не изменяется. Вы можете установить 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 скажет вам.

• Старшие разработчики — вы хотите быстрый аудит на наличие утечек секретов, дрейфа конфигурации и конфликтов правил без настройки кастомного конвейера линтинга.

• Инди-хакеры / соло-основатели — вы накопили хуки, навыки и память по разным проектам. Dear User покажет, что является осиротевшим или противоречит самому себе.

• Тимлиды — вы хотите локальный аудит общей настройки агента вашей команды. Отчеты Collab, security и health остаются на вашем компьютере; публично можно поделиться только вашей личной карточкой Wrapped.

Структура репозитория

• mcp/ — npm-пакет @poisedhq/dearuser-mcp (MCP-сервер). См. mcp/README.md для заметок по разработке.

• web/ — лендинг dearuser.ai + страницы share-report (Astro).

• docs/ — руководство по установке, документ о конфиденциальности, настройка для каждой платформы (Supabase/GitHub/Vercel для опциональных советников по безопасности).

• research/ — данные калибровки + архитектурные заметки, которыми мы готовы поделиться.

Вклад

См. CONTRIBUTING.md. Отчеты об ошибках и небольшие исправления приветствуются через GitHub issues и PR.

Сообщество и поддержка

• GitHub Discussions — вопросы, идеи, "как мне...", демонстрация

• GitHub Issues — воспроизводимые баги и запросы функций

• Почтовый ящик для обратной связи — личные заметки; или используйте MCP-инструмент feedback изнутри Claude

Ссылки

• dearuser.ai — лендинг

• Руководство по установке · Конфиденциальность · Настройка для советников по платформам

Лицензия

Dear User распространяется по лицензии MIT. См. LICENSE.

Обязательство Open-core: всё в этом репозитории является MIT и останется MIT. Если мы когда-нибудь создадим командные или хостинговые функции (агентские панели, тренды по проектам, отраслевые бенчмарки), они будут жить в отдельных репозиториях со своей лицензией — мы никогда не будем вырывать части из этого репозитория.