Motor de navegador de ChatGPT

repo-harness chatgpt browser-* usa una sesión de ChatGPT Web autenticada localmente para planificar y revisar. No usa la API de OpenAI y no requiere OPENAI_API_KEY. Los prompts se construyen a partir de archivos explícitos del repositorio, y cada ejecución se guarda como un registro de sesión local del repositorio.

El motor de navegador se ejecuta sobre Oracle — repo-harness envuelve oracle --engine browser como el proveedor por defecto y recomendado. El antiguo motor de Chrome propio se mantiene únicamente como un diagnóstico obsoleto.

Qué hace

Construye paquetes de prompt verificados por política a partir de archivos explícitos, impulsa ChatGPT Web a través de Oracle y guarda registros de sesión en .ai/harness/chatgpt/sessions/<sessionId>/.

Qué no hace

Nunca pide nombres de usuario, contraseñas, secretos de SSO, códigos 2FA, cookies ni tokens del navegador. No sube archivos arbitrarios del repositorio, no habilita CDP remoto por defecto, y nunca trata la respuesta del modelo como la fuente de verdad — el almacén de sesiones local del repositorio es el registro de auditoría.

Postura de proveedores

Oracle es el camino principal

• oracle — por defecto, recomendado. Oracle posee el motor de navegador; repo-harness siempre pasa --engine browser y desactiva el autoarchivado. Este es el proveedor que quieres.
• native — obsoleto. El motor propio del Chrome DevTools Protocol ya no recibe mantenimiento y se mantiene únicamente como diagnóstico a corto plazo (browser-doctor --provider native). Se eliminará.

1. Configuración inicial

1. Crea la raíz de sesiones e imprime las reglas de ignorado recomendadas (el estado del navegador permanece local):

   repo-harness chatgpt browser-setup --repo .

2. Haz que un binario fijado de Oracle sea resoluble — en tu PATH o en el node_modules/.bin del repositorio. Oracle es una CLI externa opcional con su propio requisito de runtime (Node ≥ 24), mantenida aparte del runtime de Bun de repo-harness.

3. Verifica que el motor esté listo (esta es la autoridad sobre el límite del runtime de Oracle):

   repo-harness chatgpt browser-doctor --repo . --provider oracle --json

   Vuelve a ejecutarlo hasta que reporte status: "ready". Si reporta nodeCompatible: false, primero corrige o reinstala el runtime de Node de Oracle.

Mantén el estado del navegador fuera del control de versiones

browser-setup imprime reglas de ignorado para los perfiles de navegador locales y los tokens de sesión. Nunca los confirmes, y nunca pegues datos de sesión en issues, PRs o registros compartidos.

2. Ejecución en seco

Valida el prompt, la política de archivos, el tamaño en línea y la ruta de escritura de la sesión sin abrir ChatGPT. Guarda una sesión dry_run.

repo-harness chatgpt browser-consult \
  --repo . \
  --dry-run \
  --prompt "Review this sprint." \
  --file plans/sprints/example.sprint.md \
  --model "GPT-5 Pro" \
  --thinking heavy

3. Ejecuta una consulta

Oracle es el proveedor por defecto, así que --provider oracle es opcional pero se muestra aquí por claridad.

repo-harness chatgpt browser-consult \
  --repo . \
  --provider oracle \
  --prompt "Review this PRD and return risks." \
  --file plans/prds/example.prd.md \
  --follow-up "Challenge your previous recommendation." \
  --write-output .ai/harness/handoff/gptpro/chatgpt-review.md

Nota

• --model selecciona el modelo de ChatGPT; --thinking <light|standard|extended|heavy> se asigna al tiempo de pensamiento del navegador de Oracle. Omite --model para mantener el modelo actualmente seleccionado en la interfaz autenticada.
• El archivo de respuesta escrito es autoritativo — stdout/stderr se tratan solo como registros.
• Una salida limpia que no produce archivo de respuesta se reporta como recuperable (ORACLE_CAPTURE_INCOMPLETE): el prompt puede ya estar enviado, así que vuelve a conectarte con browser-followup en lugar de reenviarlo.
• --write-output debe ser relativo al repositorio y no sobrescribirá un archivo existente a menos que se pase --overwrite-output; las rutas absolutas necesitan el flag exclusivo para humanos --allow-absolute-output. Mantén las salidas de GPT Pro bajo .ai/harness/handoff/gptpro/.

4. Sesiones

repo-harness chatgpt browser-list --repo .
repo-harness chatgpt browser-session --repo . chgpt_20260617_120530_review-sprint
repo-harness chatgpt browser-session --repo . chgpt_20260617_120530_review-sprint --metadata-only
repo-harness chatgpt browser-open --repo . chgpt_20260617_120530_review-sprint

Cada sesión es un registro autocontenido:

• Directorio.ai/harness/chatgpt/sessions/

  • Directorio<sessionId>/

    • meta.json metadatos, marcas de tiempo, info del proveedor
    • prompt.md el prompt de entrada
    • transcript.md conversación completa
    • output.md respuesta del asistente capturada
    • events.jsonl flujo de eventos estructurado
    • Directorioartifacts/ artefactos generados opcionales

      • …

5. Seguimientos y limpieza

Enlaza un seguimiento a una sesión guardada — reanuda esa conversación a través de Oracle:

repo-harness chatgpt browser-followup \
  --repo . \
  --session chgpt_20260617_120530_review-sprint \
  --prompt "Turn that review into a Codex-ready goal."

La limpieza usa por defecto la ejecución en seco y solo elimina candidatos cuando se pasa --force:

repo-harness chatgpt browser-cleanup --repo . --status dry_run --limit 20
repo-harness chatgpt browser-cleanup --repo . --status dry_run --limit 20 --force

6. Proveedor native (obsoleto)

Solo diagnóstico — en proceso de eliminación

El proveedor native del Chrome DevTools Protocol está obsoleto. Prefiere Oracle. Chrome 136+ también bloquea los interruptores de depuración remota contra tu directorio de datos de Chrome predeterminado, así que cualquier uso de native requiere un --profile-dir no predeterminado.

repo-harness chatgpt browser-doctor --repo . --provider native
repo-harness chatgpt browser-consult --repo . --provider native --prompt "Reply exactly OK"

Las ejecuciones de native usan el modelo/pensamiento ya seleccionado en la interfaz de ChatGPT Web; pasar --model o --thinking falla de forma cerrada. Usa Oracle cuando necesites selección de modelo del lado del proveedor.

7. Expón vía MCP (opcional)

Las herramientas de navegador están desactivadas en MCP por defecto. Actívalas explícitamente:

repo-harness mcp serve \
  --repo . \
  --transport stdio \
  --profile planner \
  --enable-chatgpt-browser

Esto expone run_chatgpt_browser_consult, read_chatgpt_browser_session, list_chatgpt_browser_sessions, open_chatgpt_browser_session y continue_chatgpt_browser_session. Las consultas por MCP restringen writeOutput a artefactos de flujo de trabajo como .ai/harness/handoff/*.md, tasks/reviews/**, .ai/harness/checks/**, plans/prds/** y plans/sprints/**.

Política de archivos y seguridad

El motor rechaza los archivos denegados antes de cualquier ejecución de navegador o proveedor, y rechaza los enlaces simbólicos de rutas permitidas que se resuelven fuera del repositorio.

• Permitidos por defecto: AGENTS.md, CLAUDE.md, README.md, docs/**, plans/**, tasks/**, .ai/context/**, .ai/harness/**, package.json
• Denegados por defecto: .env / .env.*, archivos de clave privada y certificado, .ssh/**, .git/**, node_modules/**, dist/**, build/**, coverage/**, secrets/**, credentials/**, private/**, _ops/**, .repo-harness/**/*.json

Notas de seguridad

Mantén los perfiles de navegador y la configuración local sin confirmar. No expongas la depuración remota de Chrome fuera de localhost sin un plan de seguridad explícito. Haz una ejecución en seco antes de enviar contexto grande o sensible, prefiere archivos concretos antes que volcados de todo el repositorio, y trata la salida generada por ChatGPT como entrada de revisión — no como verdad autoritativa del código.

Próximos pasos

Conector MCP Expón los artefactos de flujo de trabajo a ChatGPT y Codex por MCP.

Planificador con ChatGPT Pro El flujo de planificación y revisión, de principio a fin.