Guía
Cómo usar rezero.md
rezero.md convierte cualquier sitio web público en documentos Markdown basados en evidencia que tu agente de programación con IA puede leer. Funciona por completo en tu terminal: sin extensión de navegador, sin cuenta y sin nada que instalar.
Antes de empezar
- Node.js 22 o superior (compruébalo con node -v).
- Una terminal abierta en la carpeta de tu proyecto.
- No hace falta cuenta ni clave de API para empezar.
Inicio rápido
Ejecuta un solo comando. npx descarga el paquete la primera vez, así que no hay nada que instalar antes.
1. Analiza un sitio
Apúntalo a cualquier URL pública. Rastrea las páginas públicas y escribe ocho documentos Markdown en .rezero/<domain>/ dentro de la carpeta actual.
$ npx rezero-md analyze https://linear.app2. O prepara tu agente con init
init hace el mismo análisis y además escribe archivos de contexto para el agente (CLAUDE.md, AGENTS.md, reglas de .cursor y más) en la raíz de tu proyecto para que tu herramienta de IA los detecte automáticamente.
$ npx rezero-md init https://linear.appLo que obtienes
Ocho documentos basados en evidencia en .rezero/<domain>/, cada uno separando observación, inferencia y recomendación:
init añade archivos de contexto listos para el agente en la raíz del proyecto para que las herramientas los lean sin configuración:
Cómo funciona
Cada documento se basa en el mismo principio honesto: la evidencia antes que la opinión. Sirve para aprender cómo está construido un producto, nunca para clonarlo.
Observar
Metadatos públicos, estructura, enlaces, tokens de interfaz y firmas técnicas: solo lo que la página realmente sirve.
Inferir
Hipótesis prudentes con nivel de confianza visible, claramente marcadas como conjeturas y no como hechos.
Recomendar
Orientación transferible para adaptar un patrón a tu propio producto, no para copiar el original.
Úsalo en tu herramienta de IA
El resultado es Markdown normal en tu repositorio, así que cualquier agente puede leerlo. Para las herramientas más populares:
Claude Code
Automático. Claude Code lee CLAUDE.md y AGENTS.md en la raíz del repositorio. Ejecuta claude en la carpeta y pídele que use la referencia de rezero.md.
Cursor
Automático. El archivo .cursor/rules/rezero.mdc guía las sugerencias de Cursor. También puedes mencionar con @ los archivos de .rezero/ en el chat.
Codex CLI
Lee AGENTS.md automáticamente. Ejecuta codex en la carpeta o apúntalo a los documentos de .rezero/<domain>/.
Gemini CLI
Referencia el Markdown generado en tu prompt, p. ej. «usa los archivos de .rezero/<domain>/ como contexto de diseño».
Cualquier otro agente
Windsurf, Cline, Continue y otros: todo es Markdown normal en .rezero/, así que añade esos archivos al contexto de la herramienta.
Generación completa con IA (opcional)
Sin clave, rezero.md escribe documentos iniciales deterministas para que veas la estructura al instante. Configura GEMINI_API_KEY (u OPENAI_API_KEY) para un análisis completo escrito por IA. Tu clave y tus archivos permanecen en tu máquina.
$ export GEMINI_API_KEY=your_key_here$ npx rezero-md init https://linear.appSolución de problemas
El comando no hace nada o dice «not found».
Confirma Node.js 22+ con node -v y ejecuta npx rezero-md analyze <url>. npx descarga el paquete la primera vez; no necesitas instalación global.
Los documentos se ven pobres o genéricos.
Es la salida inicial sin clave. Configura GEMINI_API_KEY (u OPENAI_API_KEY) para el análisis completo, o explora la biblioteca, donde las entradas ya están generadas por completo.
«No public HTML pages could be fetched.»
El objetivo debe ser una página pública que permita el rastreo. Usa la URL pública del sitio y asegúrate de que no esté tras un inicio de sesión ni bloqueando bots.
¿Dónde están los archivos?
En .rezero/<domain>/ dentro de la carpeta donde ejecutaste el comando, más CLAUDE.md, AGENTS.md y los demás archivos de contexto cuando usas init.
¿Listo para probarlo?
Explora productos ya analizados o genera el tuyo con un solo comando.