La CLI de SeeRepo

La CLI de SeeRepo muestra el mapa de tu proyecto en la terminal: un módulo como árbol con lo que hace cada parte, qué cambió desde ayer y un módulo abierto en el navegador. Sirve para ti, y para un agente que puede correr comandos. Lee a través de la API con tu clave. Con una clave a la que le permitas escribir, también hace tres cambios, y pregunta antes de cada uno.

Necesita Node.js 18 o posterior.

1. Ejecútala

Ejecútala sin instalarla:

npx seerepo login

O instálala, si la vas a usar a menudo:

npm install -g seerepo

2. Entra

seerepo login

Te pide una clave de API: crea una en Ajustes → API / MCP y pégala. La CLI dice con qué cuenta quedó conectada y guarda la clave en ~/.config/seerepo/config.json, que solo puedes leer tú.

3. Úsala en la carpeta de tu proyecto

La CLI reconoce el repo por el remoto de git de la carpeta, en GitHub. Fuera de la carpeta, añade --repo owner/name.

Si SeeRepo también sigue la rama en la que está tu carpeta, la CLI lee el mapa de esa rama. Añade --branch nombre para elegir tú la rama.

Ver un módulo

seerepo map
seerepo map /checkout

ana/tienda
A shop.

├─ ☺ Shoppers
├─ ◆ Checkout — Takes the payment and confirms the order.  → /checkout
├─ ◆ Catalog — Lists the products.  → /catalog
└─ ▤ Data — Orders and products.  → /data

Outside services: Stripe

Go inside: seerepo map /checkout

Cada módulo (◆) tiene su ruta: seerepo map con esa ruta entra en él. Lo que escribe la CLI va en inglés, como todo lo que genera SeeRepo.

Ver qué cambió

seerepo changes
seerepo changes --since 2026-10-19

Por defecto, las últimas 24 horas: cuándo, qué agente o persona, qué cambió en palabras sencillas y los módulos que tocó.

Abrir un módulo en el navegador

seerepo open /checkout

Comandos

Comando	Qué hace
seerepo login	Guarda tu clave de API
seerepo map [ruta]	Un módulo como árbol; / por defecto
seerepo changes [--since fecha]	Los commits desde una fecha; por defecto, las últimas 24 horas
seerepo impact <archivo> [--name x] [--to archivo]	Qué depende de un archivo: quién lo nombra, cuántos, qué páginas y procesos
seerepo pages	Cuántas pantallas y cuántas están listas, como lo dice la app, y cada página: quién entra (o «no se ve la puerta» donde SeeRepo no puede leerla; Python aún no tiene Páginas), los estados que maneja o le faltan y, si solo te lleva a otro sitio, adónde y la línea que lo hace
seerepo found	Cuántas páginas públicas se pueden encontrar, como el aro de Visibilidad, y cómo ven los buscadores y la IA cada una, y qué necesita trabajo
seerepo health [n]	La nota, si se puede publicar y las tareas numeradas; con un número, el prompt de esa tarea (seerepo health 1 | pbcopy). En un repo gratis, cuántas hay y el título de la primera
seerepo history	Los últimos 7 días, el ritmo y los momentos
seerepo docs [página]	La wiki del repo: su árbol, o un capítulo con versión guardada, fecha del documento, idioma, autoría, markdown completo, diagrama y fuentes
seerepo open [ruta]	Abre ese módulo en SeeRepo
seerepo ignore <ruta…>	Deja rutas fuera del mapa, como hace Ajustes → Ignorar
seerepo false <tarea> --why "…"	Marca como falsa una tarea de Salud; --files a,b para solo algunos de sus archivos
seerepo snooze <tarea> --days 7	Pospone una tarea, de 1 a 90 días
seerepo accept <tarea> --why "…"	Acepta una tarea como está
seerepo claim [--days 90]	Los commits que Codex y Claude Code hicieron en este repo sin firmar, encontrados en sus sesiones de esta computadora. Los enseña por agente y, con tu sí, los reclama para cada uno; de la computadora nunca sale una sesión, solo cada commit y su agente
--repo owner/name	El repo, cuando no estás en su carpeta
--branch nombre	Una de las ramas que SeeRepo sigue en ese repo; por defecto, la de la carpeta si SeeRepo la sigue, o la principal
--version, --help	Su versión y la lista de comandos

Los cinco cambios (con claim) necesitan una clave a la que le permitas escribir (en Ajustes → API / MCP). <tarea> es su número en seerepo health, o su clave. Cada uno dice lo que va a pasar y pregunta Apply? (y/N): sin una terminal donde contestar, no se aplica nada.

Cuando algo falla

• «This folder isn't a GitHub repo»: ejecútala en la carpeta de tu proyecto, o añade --repo owner/name.
• «… isn't connected to SeeRepo»: conecta el repo en tu panel y vuelve a ejecutarla.
• «… doesn't follow the branch …»: SeeRepo solo lee las ramas que añadiste en los ajustes del proyecto; el mensaje las dice.
• «Your key doesn't work»: la revocaron o está mal escrita. Ejecuta seerepo login con una nueva.