CodeTour

Анимированные, управляемые LLM "объясни, как пятилетнему" туры по pull request'ам GitHub.

CodeTour — это MCP сервер в паре с локальным браузерным просмотрщиком. Клод (или любая LLM, управляющая MCP) вызывает инструменты CodeTour шаг за шагом; просмотрщик анимирует проход по pull request — дерево файлов, диффы, пульсирующие подсветки строк — пока повествование показывается в виде подписей и озвучивается через встроенный синтез речи браузера. Каждая остановка ссылается обратно на GitHub, чтобы зрители могли сами углубиться в детали.

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

Claude ──(MCP stdio)──▶ codetour ──(WebSocket)──▶ your browser
                          │
                          └──(REST)──▶ GitHub API

1. LLM вызывает get_pr_info / get_file_diff, чтобы прочитать PR через CodeTour, поэтому его повествование точно соответствует тому, что отображается.

2. start_tour открывает просмотрщик в вашем браузере и ждет, когда вы нажмете Start (клик также включает звук).

3. show_overview и серия вызовов show_step анимируют изменения. Каждый вызов блокируется до окончания озвучивания повествования, поэтому тур идет в естественном темпе.

4. end_tour показывает итоговое резюме со ссылкой на PR на GitHub.

Установка

Требуются Python 3.11+ и uv.

git clone <this repo> && cd CodeTour
uv sync

Зарегистрируйте в Claude Code в области пользователя, чтобы инструменты были доступны в каждом репозитории:

claude mcp add --scope user codetour -- uv --directory /path/to/CodeTour run codetour

Затем просто попросите:

Дай мне обзорный тур по https://github.com/owner/repo/pull/123

Навык codetour

В репозитории поставляется навык Claude Code (skills/codetour/SKILL.md) который обучает Клода мастерству хорошего тура: автоматическое определение PR текущей ветки через gh, планирование 3–7 остановок перед открытием просмотрщика, правила стиля повествования ELI5 и как восстановиться, когда просмотрщик закрыт. Установите его, создав ссылку (или скопировав) в ваш личный каталог навыков:

ln -s /path/to/CodeTour/skills/codetour ~/.claude/skills/codetour

С установленным навыком простая команда "tour this PR" в любом репозитории делает то, что нужно. Перезапустите сессию Claude Code после установки MCP-сервера или навыка.

Аутентификация GitHub

Публичные PR работают без аутентификации (низкий лимит запросов). Для приватных репозиториев или более высокого лимита, CodeTour использует первый из: GITHUB_TOKEN, GH_TOKEN или сохраненный токен CLI gh (gh auth login).

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

Разработка

uv run pytest                 # unit tests
uv run ruff check .           # lint
uv run codetour --demo        # web viewer only, replays a canned tour on a loop

Демо-режим — это самый быстрый способ итерации по фронтенду: ему не нужен ни MCP-клиент, ни доступ к GitHub — откройте напечатанный URL, нажмите Start и смотрите готовый тур.

Инструменты MCP