devcoach

Оставайтесь в форме, пока ваш ИИ делает работу.

devcoach подключается к Claude Code, Claude Desktop, Gemini CLI (бета), Codex CLI (бета), Cursor, Windsurf и другим MCP-совместимым инструментам. После каждой выполненной вами задачи он выдаёт короткий точечный урок с учётом того, что вы уже знаете, — без общих туториалов, без повторов, открывать ничего не нужно.

Всё работает локально. Никакие данные не покидают ваш компьютер. Один SQLite-файл в ~/.devcoach/coaching.db.

Работает на официальном Model Context Protocol TypeScript SDK, встроенном в Node модуле node:sqlite, Hono (веб-панель) и Commander (CLI). Требуется Node.js ≥ 24.

Зачем нужен devcoach?

ИИ-агенты теперь пишут значительную часть нашего кода — из-за этого легко выпускать больше, понимая меньше. devcoach превращает каждую задачу, завершённую вашим агентом, в один короткий урок в контексте, так что вы продолжаете учиться по ходу дела. Более глубокая ставка: по мере роста возможностей ИИ дефицитным навыком становится проверка того, что он создаёт, — а эта способность сохраняется, только если вы продолжаете её практиковать.

→ Зачем существует devcoach

Related MCP server: daruma

Как это работает

flowchart TD
    A([Task completed]) --> B{"stop-hook:<br/>paced + rate limit ok?"}
    B -->|not yet| Z(["Silent — counter +1"])
    B -->|due| C["Cue: activate the devcoach skill"]

    subgraph skill["devcoach skill"]
        C --> D{"Technical work?"}
        D -->|no| S[skip_lesson]
        D -->|yes| E[Select topic & depth]
        E --> G[log_lesson]
        G --> F[Print lesson card]
    end

    S --> Y(["Silent — pacing re-armed"])
    F --> H(["Done — counter reset"])
    F -.->|prompts| U(["You: ✅ / ❌"])

→ Полная схема принятия решений: запуск сессии · выбор урока · калибровка глубины

Конфиденциальность по замыслу

Всё остаётся на вашем компьютере. Никакой телеметрии, аккаунтов и обращений на внешние серверы. Просто один SQLite-файл.

→ Конфиденциальность и безопасность

Установка

devcoach работает локально — это stdio MCP-сервер, который хранит всё в ~/.devcoach/coaching.db на той машине, где запущен ваш агент. Он работает в Claude Code, Claude Desktop, Gemini CLI (бета) и Codex CLI (бета), но не в claude.ai web (там поддерживаются только размещённые/удалённые коннекторы).

Требуется Node.js ≥ 24 (devcoach использует встроенный модуль node:sqlite, доступный только начиная с Node 24).

Выбирайте по своему стилю работы — каждый раздел самодостаточен (установка и подключение):

• Разработчик, которому удобен терминал → Homebrew — одна команда brew install, и вы получаете также CLI devcoach.

• Предпочитаете установку в один клик без терминала → плагин Claude Code или расширение .mcpb.

• MCP-клиент с поддержкой реестра? devcoach указан в официальном MCP Registry как io.github.UltimaPhoenix/devcoach — установите его прямо оттуда.

• Всё остальное (npx, ручная настройка, другие агенты, claude.ai web) — в разделе Другие способы установки.

Homebrew (рекомендуется разработчикам)

macOS / Linux. Один раз добавьте и доверьте tap, установите, затем подключите — вы также получаете CLI devcoach (поэтому devcoach ui и CLI работают без префикса npx):

# 1. Add the tap — registers github.com/UltimaPhoenix/homebrew-tap with Homebrew
brew tap UltimaPhoenix/tap

# 2. Trust the whole tap — required when Homebrew enforces HOMEBREW_REQUIRE_TAP_TRUST
brew trust --tap UltimaPhoenix/tap

# 3. Install
brew install devcoach

# 4. Connect (Homebrew puts `devcoach` on your PATH — no `npx -y` prefix needed)
devcoach install

brew tap регистрирует сторонний репозиторий; brew trust --tap помечает его как доверенный, чтобы Homebrew загружал его формулы, когда установлена переменная HOMEBREW_REQUIRE_TAP_TRUST. Обе команды выполняются один раз. Для обновления позже: brew upgrade devcoach. Одной строкой: brew install UltimaPhoenix/tap/devcoach (сначала выполните brew trust --tap UltimaPhoenix/tap, если ваш Homebrew требует доверия к tap). Формула объявляет depends_on "node", поэтому Homebrew автоматически подтянет свежую версию Node.

Плагин Claude Code (рекомендуется для Claude Code) — Бета

Самый простой способ добавить devcoach в Claude Code — один клик, ничего настраивать не нужно. Плагин включает всё (MCP-сервер + Stop-хуки автоматического обучения + навык), поэтому не запускайте также devcoach install (иначе Stop-хуки зарегистрируются дважды).

# Add the marketplace once, then install (you can install any UltimaPhoenix plugin from it later)
/plugin marketplace add UltimaPhoenix/claude-plugins-marketplace
/plugin install devcoach@ultimaphoenix

MCP-сервер, хуки и навык активируются при установке — перезапуск не нужен. Плагин не добавляет CLI devcoach, поэтому запускайте панель или CLI через npx -y devcoach ui (или используйте Homebrew / npm i -g devcoach, чтобы команда devcoach была доступна без префикса).

# Straight from the devcoach repo (no separate marketplace)
/plugin marketplace add UltimaPhoenix/dev-coach
/plugin install devcoach@devcoach

# Offline — download devcoach-plugin-<version>.zip from a GitHub Release, unzip, then:
/plugin marketplace add /path/to/unzipped-folder
/plugin install devcoach@devcoach

Подробнее о принципе работы — в разделе Плагин Claude Code.

Расширение Claude Desktop (.mcpb) (рекомендуется для Claude Desktop) — Бета

Единый пакет, который работает во встроенной среде выполнения Claude Desktop — Node или терминал не нужны. Каждый GitHub Release включает такой пакет:

1. Скачайте devcoach-<version>.mcpb из последнего релиза

2. Claude Desktop → Настройки → Расширения → Установить расширение… → выберите файл .mcpb

Пакет самоподписанный, поэтому Claude Desktop устанавливает его как непроверенного издателя (для проверенной подписи потребовался бы настоящий сертификат подписи кода). Предпочитаете собрать его из исходников?

npm run mcpb        # → dist-mcpb/devcoach-<version>.mcpb   (npm run mcpb:sign self-signs it)

Другие способы установки — Бета

Устанавливать ничего не нужно — npx запускает devcoach по требованию. Для Claude Code и Claude Desktop одна команда регистрирует MCP-сервер, настраивает автоматическую доставку уроков (Stop-хуки) и устанавливает обучающий навык в ~/.claude/skills/devcoach/:

npx -y devcoach install

После этого перезапустите агента. Предпочитаете глобальный бинарник? npm install -g devcoach, затем выполните devcoach install (и уберите префикс npx -y везде). После обновления devcoach повторно запустите devcoach install, чтобы обновить навык, — devcoach stats напомнит, когда он устарел.

Вариант A — через CLI claude mcp (рекомендуется):

claude mcp add devcoach npx -- -y devcoach mcp

# all projects (user scope)
claude mcp add --scope user devcoach npx -- -y devcoach mcp

Вариант B — отредактируйте ~/.claude.json напрямую:

{ "mcpServers": { "devcoach": { "type": "stdio", "command": "npx", "args": ["-y", "devcoach", "mcp"] } } }

Затем добавьте хуки в ~/.claude/settings.json для автоматической доставки уроков — stop-hook решает после каждого хода, пора ли урок, а prompt-hook заранее готовит модель, когда урок пора:

{
  "hooks": {
    "Stop": [
      { "hooks": [{ "type": "command", "command": "npx -y devcoach stop-hook", "timeout": 60 }] }
    ],
    "UserPromptSubmit": [
      { "hooks": [{ "type": "command", "command": "npx -y devcoach prompt-hook", "timeout": 30 }] }
    ]
  }
}

Совет: глобальная установка помещает devcoach в ваш PATH, так что можно убрать префикс npx -y. devcoach install обнаруживает это автоматически. Используете плагин Claude Code (выше)? Пропустите хуки здесь — плагин уже предоставляет их.

Одна команда регистрирует MCP-сервер, хуки уроков AfterAgent/BeforeAgent и обучающий навык:

npx -y devcoach install --gemini

Или вместо этого установите встроенное расширение Gemini: скачайте devcoach-gemini-extension-<version>.zip из последнего релиза, распакуйте и выполните gemini extensions install <folder>. Выберите один из двух способов (оба дают одинаковые хуки; devcoach обнаружит расширение и пропустит дубли). Подробности: docs/install/gemini-cli.md.

Одна команда регистрирует MCP-сервер (codex mcp add), хуки уроков Stop/UserPromptSubmit (~/.codex/hooks.json) и обучающий навык (~/.agents/skills/):

npx -y devcoach install --codex

При следующем запуске Codex попросит довериться новым хукам — подтвердите, иначе обучение останется неактивным. Подробности: docs/install/codex.md.

Добавьте это в MCP-конфиг вашего агента (или, если ваш клиент поддерживает MCP Registry, установите io.github.UltimaPhoenix/devcoach оттуда):

{
  "mcpServers": {
    "devcoach": {
      "command": "npx",
      "args": ["-y", "devcoach", "mcp"]
    }
  }
}

Stop-хуки (автоматическая доставка уроков после каждой задачи) существуют для Claude Code, Gemini CLI и Codex CLI. Агенты из этой таблицы имеют полный доступ ко всем MCP-инструментам и ресурсам — обучение можно запускать вручную или попросив об этом агента.

Claude.ai не поддерживает MCP-серверы. Вместо этого установите обучающие инструкции как навык:

1. Скопируйте содержимое assets/SKILL.md

2. Перейдите в claude.ai → Настройки → Пользовательские инструкции (или Навыки, в зависимости от вашего тарифа)

3. Вставьте содержимое и сохраните

Это даст claude.ai обучающее поведение без MCP-инструментов (журнал уроков и отслеживание профиля работать не будут).

Держите навык в актуальном состоянии. Для Claude Code / Claude Desktop навык раздаётся автоматически (через MCP-промпт или плагин) и всегда актуален. Если вы скопировали его вручную в claude.ai, повторно вставьте последнюю версию SKILL.md после каждого обновления devcoach.

Онбординг

При первом подключении агента к devcoach он обнаруживает, что ваш профиль ещё не настроен, и проводит вас по настройке прямо в чате — отдельная команда не нужна. (Предпочитаете терминал? devcoach setup запускает тот же мастер.)

→ Полное руководство по онбордингу

Этап 1 — Выберите способ настройки профиля

devcoach сканирует всю локальную историю Claude Code (каждый проект, в котором работал агент, отсортированный по недавней активности, — только метаданные файлов и активности, никогда текст промптов) и предлагает четыре способа построить профиль:

devcoach: Your knowledge profile isn't set up yet. I scanned 9 of your Claude Code
projects and found TypeScript (dev-coach), Java (discordbot), Swift (blueprince).

  1. Automatic (strongly recommended) — build the profile from that, no questions asked
  2. Automatic (Deep)   — also read my local session transcripts for a sharper profile
  3. Guided             — a step-by-step conversation about my stack
  4. Import backup      — restore a devcoach backup zip

Этап 2 — Создайте профиль

Автоматический (настоятельно рекомендуется)

Создаёт весь профиль — темы, оценки уверенности, группы и обучающий блокнот — за один проход на основе стека, обнаруженного в вашей истории. Без вопросов: вы просматриваете и корректируете результат после (в чате, через CLI или в панели).

Автоматический (глубокий)

По желанию. Всё, что делает автоматический режим, плюс отдельный субагент читает реальный текст диалогов из локальных транскриптов сессий Claude Code (~/.claude/projects/), чтобы получить максимально точный профиль и блокнот. Сначала выполняется проверка только метаданных за скользящее окно в 3 месяца; если найдено более 8 проектов, devcoach спрашивает, сузить окно, продолжить с 25 самыми недавними или выбрать конкретные проекты. Агент сразу предупреждает: при этом модели передаётся больше вашей локальной истории, чем при сканировании метаданных, — один раз, на этой машине, как шаг настройки.

С помощью мастера

Предпочитаете описать свой стек самостоятельно? devcoach спрашивает о каждой технологии и вашем уровне уверенности (1–3 ещё учусь · 4–6 уверенно · 7–9 сильно · 10 эксперт), согласовывает с вами группы тем, затем сохраняет профиль.

Импорт резервной копии

На новой машине или после переустановки? Укажите путь к вашему zip-файлу резервной копии — и ваш полный профиль (карта знаний, уроки, настройки и блокнот) будет восстановлен мгновенно.

Этап 3 — профиль сохранён, обучение начинается

После сохранения ваш агент покажет, что было настроено, с группировкой в соответствии с вашей картой знаний — для автоматических режимов это первый взгляд на неё, так что сейчас самое время попросить об изменениях:

✓ Profile saved — 24 topics across 6 groups.

### Languages
- **typescript** — 7/10
- **java** — 5/10

### DevOps
- **docker** — 7/10
- **github_actions** — 6/10

### Other
- **regex** — 4/10

Change any of this later in chat ("set my Java confidence to 7"), with the
`devcoach` CLI, or in `devcoach ui`.

Вот и всё. Вы возвращаетесь к работе. Обучение происходит незаметно в фоне.

Ваш первый урок

Вы работаете над задачей как обычно. После ответа вашего агента devcoach добавляет урок:

You: Refactor this endpoint to handle concurrent requests properly.

Agent: [refactors the code, explains the changes]

### ──────── 🎓 devcoach ────────
**Promise.allSettled vs Promise.all — don't let one failure sink the batch** · TypeScript · Mid

Promise.all rejects the moment any promise rejects, and you lose the results of
the ones that already succeeded. For independent work (fan-out fetches, batch
writes) that's usually the wrong default.

Promise.allSettled always resolves, giving you a status for every promise:

    const results = await Promise.allSettled(ids.map(fetchUser));
    const ok = results.filter(r => r.status === "fulfilled").map(r => r.value);

Use Promise.all when the tasks are genuinely all-or-nothing; reach for
allSettled when partial success is meaningful and you want to report failures.

💡 *Senior tip:* for coordinated work that *should* cancel siblings on failure,
an AbortController shared across the requests gives you all-or-nothing with
prompt cancellation — the structured-concurrency middle ground.
### ──────── typescript · mid ────────

Did that land? ✅ know (y) · ❌ don't know (n)

Ответьте y или n (или ✅ / ❌), чтобы скорректировать уровень уверенности по этой теме и формировать будущие уроки — или просто идите дальше: отсутствие ответа означает отсутствие изменений.

Скриншоты

Контекст и персонализация

Каждый урок сохраняет где он произошёл — папку проекта, репозиторий, ветку, хеш коммита, редактор. Вы также можете персонализировать обучение с помощью учебного блокнота в ~/.devcoach/learning-state.md, который определяет, какие темы devcoach приоритизирует и насколько глубокими будут уроки.

→ Учебный блокнот · Руководство по веб-панели

Веб-панель

Откройте веб-панель в любой момент, чтобы просмотреть прогресс, отредактировать профиль или управлять настройками:

npx -y devcoach ui   # → http://localhost:7860

Полная документация: docs/usage/web-ui.md

Справочник по CLI

CLI — это дополнительный интерфейс для запросов и управления данными обучения. Всё также доступно в веб-панели. Выполните devcoach --help или devcoach <command> --help, чтобы увидеть полное описание использования.

(Добавьте npx -y перед командой, если пакет не установлен глобально.) Полная документация: docs/usage/cli.md

Конфигурация

По умолчанию: до 2 уроков в день, с интервалом не менее 4 часов. Нужно больше обучения? Нужно меньше? Измените это.

devcoach set max_per_day 5           # more lessons per day
devcoach set min_gap_minutes 60      # lessons closer together

Или воспользуйтесь страницей настроек в веб-панели. Все параметры перечислены в docs/reference/configuration.md.

Ожидаемые результаты

За обычную рабочую неделю с 1–2 задачами в день вы получите 2–4 урока, соответствующих вашему стеку и уровню уверенности. Чтение каждого урока занимает 30 секунд. Через месяц обычной разработки с помощью ИИ вы соберёте учебный блокнот, отражающий ваши пробелы, — точные паттерны, с которыми вы боретесь, крайние случаи, которые вы склонны упускать, логику, стоящую за инструментами, к которым вы инстинктивно обращаетесь.

Слишком интенсивно? Уменьшите частоту: devcoach set max_per_day 1. Хотите больше обучения? Увеличьте: devcoach set max_per_day 5. Всё настраивается.

Накопительный эффект: разработчики, которые продолжают учиться, пока инструменты становятся мощнее, сохраняют контроль над результатом.

Устранение неполадок

«Ошибка версии Node»

devcoach требует Node.js ≥ 24. Проверьте версию: node --version. Если у вас ниже 24, обновитесь: brew upgrade node (Homebrew) или nvm install 24 (если используете nvm).

«MCP-сервер не подключается»

Выполните devcoach install, чтобы заново зарегистрировать сервер в Claude Code или Claude Desktop, затем перезапустите агента. Если проблема остаётся, проверьте ~/.claude.json (Claude Code) и убедитесь, что запись devcoach присутствует и команда указана корректно.

«Обучение не запускается / уроки не появляются»

Выполните devcoach doctor — он проверяет все связи (версию Node, записи хуков в ~/.claude/settings.json, а также ~/.gemini/settings.json и ~/.codex/hooks.json, если они есть, навык, регистрацию MCP, базу данных, счётчики темпа, лимит частоты) и завершается вердиктом, объясняющим, почему следующая остановка вызовет или не вызовет подсказку урока. Помните, что темп намеренно сдержанный: при настройках по умолчанию урок предлагается только после nudge_every взаимодействий в сессии и в пределах лимитов частоты — это задумано, а не ошибка. Для трассировки в реальном времени установите DEVCOACH_HOOK_DEBUG=1 и следите за ~/.devcoach/hook.log: каждый запуск хука добавляет одну строку с его решением (paced (3/10), rate limited: …, cue). Хуки существуют для Claude Code, Gemini CLI (бета) и Codex CLI (бета); другие агенты (Cursor, Windsurf, Cline) их не поддерживают — обучение доступно по запросу через MCP-инструменты или ручные запросы.

«Произошла ошибка Stop hook» рядом с уроком

Это уведомление — нынешняя формулировка Claude Code для любого блокирующего Stop-хука, включая подсказку урока devcoach (сопутствующая строка «🎓 devcoach…» говорит вам, что это обучение, а не сбой). Оно безвредно и, по замыслу, также редко: подготавливающий хук UserPromptSubmit доставляет большинство уроков в рамках того же хода, поэтому блокирующий запасной вариант срабатывает только в том случае, если этого не произошло.

«Ошибка прав доступа к SQLite»

devcoach записывает данные в ~/.devcoach/coaching.db. Если возникает ошибка прав доступа, проверьте, что каталог существует и у вас есть права на запись: ls -ld ~/.devcoach. Если его нет, выполните devcoach install или devcoach setup, чтобы инициализировать его.

Известные ограничения

• claude.ai web: MCP-серверы не поддерживаются. Вы можете использовать копию навыка (только поведение обучения, без хранения данных).

• Эфемерные песочницы: Если ваш агент запускается в новой песочнице при каждом перезапуске (например, GitHub Codespaces), devcoach не может сохранять данные между сессиями. В текущей сессии всё работает нормально, но уроки не переносятся.

• Windows: devcoach протестирован на macOS и Linux. Поддержка Windows зависит от Node.js ≥ 24 и наличия node:sqlite (в целом стабильно, но сообщайте о проблемах).

• Многопользовательские машины: devcoach записывает данные в ~/.devcoach/, поэтому у каждого пользователя своя база данных обучения. Профили не передаются между пользователями.

Удаление

npm uninstall -g devcoach          # if installed globally (npx: nothing to remove)
brew uninstall devcoach            # if installed via Homebrew (brew untap UltimaPhoenix/tap to drop the tap)
claude mcp remove --scope user devcoach   # remove from Claude Code (install uses user scope)
rm -rf ~/.devcoach                 # delete all coaching data (back up first: devcoach backup)

Для Claude Desktop удалите ключ devcoach из файла конфигурации платформы (пути указаны в разделе Ручная настройка выше). Также удалите две записи хуков из ~/.claude/settings.json — одну из hooks.Stop (devcoach stop-hook) и одну из hooks.UserPromptSubmit (devcoach prompt-hook).

Подробнее

Полная документация: README — это краткое введение. Подробные руководства доступны в официальной документации:

• Почему существует devcoach — философия

• Обучение в вашем агенте — первичная настройка, ваш первый урок, цикл обратной связи

• Использование веб-панели — настройте карту знаний, фильтруйте уроки, переходите к контексту кода

• Справочник по CLI — все команды для запросов и управления данными

• Установка — все способы установки, для каждого агента

• Конфигурация — лимиты частоты, темп, место хранения данных, схема

• Конфиденциальность и безопасность — локальная архитектура, что читается и сохраняется

• Как это работает — запуск сессии, цикл обучения, выбор уроков

• Видение и дорожная карта — бесплатно, локально, без коммерциализации; идеи, которые мы исследуем дальше

• Маркетплейс плагинов — коллекция плагинов UltimaPhoenix

Сообщество

• Поставьте звёздочку репозиторию — помогите другим узнать о нём

• GitHub Issues — запросы функций, отзывы и вопросы: откройте issue

Вклад в проект

Помощь приветствуется! Начните с CONTRIBUTING.md.

Разработка

git clone https://github.com/UltimaPhoenix/dev-coach && cd dev-coach
npm install
npm run dev -- mcp        # run the MCP server from source
npm run dev -- ui         # run the web dashboard from source
npm run lint && npm run typecheck && npm test
npm run build             # tsup → dist/bin.js
npm run mcpb              # build the Claude Desktop .mcpb (npm run mcpb:sign to self-sign)

• MCP Inspector: npx @modelcontextprotocol/inspector node dist/bin.js mcp

• Стек: @modelcontextprotocol/sdk · node:sqlite · Hono · Commander · Zod · Biome · Vitest · tsup

Публикация релиза

Пометьте коммит тегом v*:

git tag v1.2.3 && git push origin v1.2.3

CI выполняет линтинг, проверку типов, тесты (Node 24 и 26), сборку и публикует в npm через OIDC provenance (npm publish --provenance). При первой настройке: настройте Trusted Publisher на npmjs.com для пакета devcoach (GitHub Actions, репозиторий UltimaPhoenix/dev-coach, workflow ci.yml).

Лицензия

Авторские права (C) 2026 UltimaPhoenix

devcoach распространяется по лицензии GNU Affero General Public License v3.0 (AGPL-3.0-only). Вы можете использовать, изменять и распространять его — при условии, что любая изменённая версия, которую вы распространяете или запускаете как сетевой сервис, также выпускается как открытое программное обеспечение под AGPL. Сегодня коммерческая лицензия не предлагается; если она вам действительно нужна — встраивание devcoach в закрытый продукт или выпуск проприетарного производного — откройте issue, описав свою ситуацию, и она будет рассмотрена в индивидуальном порядке.

Часто задаваемые вопросы о лицензировании

devcoach был и остаётся на 100% бесплатным для загрузки, установки и использования — для всех, навсегда, в том числе на работе и в коммерческих проектах. AGPL — это не ценник: вы платите только в том случае, если хотите выпустить проприетарное/закрытое производное от самого devcoach, не соблюдая условия AGPL.

Использование devcoach не переводит ваш код под лицензию AGPL. Он работает как отдельный процесс через stdio/MCP (npx -y devcoach mcp); взаимодействие с ним на расстоянии не является производной работой — точно так же, как запросы к базе данных под лицензией AGPL. Ваши собственные проекты сохраняют любую лицензию, которую вы выберете.

• ✅ «Я использую devcoach внутри Claude Code при разработке своего стартап-приложения с закрытым исходным кодом.» — Бесплатно. Ваше приложение остаётся проприетарным, никаких обязательств.

• ✅ «Вся моя команда устанавливает devcoach, чтобы получать коучинг по нашим внутренним/коммерческим репозиториям.» — Бесплатно. Использование неизменённого инструмента в компании допустимо.

• ⚠️ «Я создаю форк devcoach, добавляю функцию и публикую пакет или размещаю его дашборд как публичный сервис.» — Вы должны выпустить исходный код вашей модифицированной версии devcoach под лицензией AGPL.

• 💼 «Я хочу встроить devcoach в свой платный продукт и оставить свои изменения закрытыми.» — AGPL этого не позволяет; коммерческая лицензия сегодня не предлагается — сначала задайте вопрос через issue.

Продолжайте использовать devcoach как инструмент/исполняемый файл (не как импортируемую библиотеку) — и AGPL никогда не затронет ваш собственный код.