CodeTour

Animados e impulsados por LLM, "explica como si tuviera cinco años" recorridos de los pull requests de GitHub.

CodeTour es un servidor MCP que se complementa con un visor local en el navegador. Claude (o cualquier LLM que maneje MCP) llama a las herramientas de CodeTour paso a paso; el visor anima el pull request — árbol de archivos, diffs, resaltados de línea pulsantes — mientras la narración se muestra como subtítulos y se dice en voz alta mediante la función de texto a voz integrada en el navegador. Cada parada enlaza de vuelta a GitHub para que los espectadores puedan profundizar en los detalles por su cuenta.

Cómo funciona

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

1. El LLM llama a get_pr_info / get_file_diff para leer el PR a través de CodeTour, de modo que su narración coincida exactamente con lo que se muestra.

2. start_tour abre el visor en tu navegador y espera a que hagas clic en Iniciar (el clic también activa el audio).

3. show_overview y una serie de llamadas a show_step animan los cambios. Cada llamada se bloquea hasta que la narración termina de hablar, por lo que el recorrido se marca su propio ritmo de forma natural.

4. end_tour muestra un resumen final con un enlace al PR en GitHub.

Instalación

Requiere Python 3.11+ y uv.

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

Regístralo con Claude Code en el ámbito de usuario para que las herramientas estén disponibles en todos los repositorios:

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

Entonces solo pregunta:

Dame un recorrido ejecutivo de https://github.com/owner/repo/pull/123

La habilidad codetour

El repositorio incluye una habilidad de Claude Code (skills/codetour/SKILL.md) que enseña a Claude el arte de un buen recorrido: detectar automáticamente el PR de la rama actual mediante gh, planificar de 3 a 7 paradas antes de abrir el visor, reglas de estilo de narración ELI5 y cómo recuperarse cuando se cierra el visor. Instálala enlazándola (o copiándola) en tu directorio personal de habilidades:

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

Con la habilidad instalada, un simple "recorre este PR" en cualquier repositorio hace lo correcto. Reinicia tu sesión de Claude Code después de instalar el servidor MCP o la habilidad.

Autenticación de GitHub

Los PR públicos funcionan sin autenticación (límite de tasa bajo). Para repositorios privados o un límite mayor, CodeTour usa el primero de: GITHUB_TOKEN, GH_TOKEN o el token almacenado de la CLI gh (gh auth login).

Configuración

Desarrollo

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

El modo demo es la forma más rápida de iterar en el frontend: no necesita ningún cliente MCP ni acceso a GitHub — abre la URL impresa, haz clic en Iniciar y mira el recorrido de muestra.

Herramientas MCP