Moteur navigateur ChatGPT

repo-harness chatgpt browser-* pilote une session ChatGPT Web authentifiée localement pour la planification et la revue. Il n’utilise pas l’API OpenAI et ne requiert pas OPENAI_API_KEY. Les prompts sont construits à partir de fichiers de dépôt explicites, et chaque exécution est enregistrée comme un enregistrement de session repo-local.

Le moteur navigateur s’appuie sur Oracle — repo-harness encapsule oracle --engine browser comme provider par défaut et recommandé. L’ancien moteur Chrome maison n’est conservé que comme diagnostic déprécié.

Ce qu'il fait

Construit des lots de prompts vérifiés par politique à partir de fichiers explicites, pilote ChatGPT Web via Oracle, et enregistre les enregistrements de session sous .ai/harness/chatgpt/sessions/<sessionId>/.

Ce qu'il ne fait pas

Ne demande jamais de noms d’utilisateur, mots de passe, secrets SSO, codes 2FA, cookies ni jetons de navigateur. Ne téléverse pas de fichiers de dépôt arbitraires, n’active pas le CDP distant par défaut, et ne traite jamais la réponse du modèle comme la source de vérité — le magasin de sessions repo-local est l’enregistrement d’audit.

Posture des providers

Oracle est la voie principale

• oracle — par défaut, recommandé. Oracle possède le moteur navigateur ; repo-harness passe toujours --engine browser et désactive l’archivage automatique. C’est le provider que vous voulez.
• native — déprécié. Le moteur Chrome DevTools Protocol maison n’est plus maintenu et n’est conservé que comme diagnostic à court terme (browser-doctor --provider native). Il sera retiré.

1. Configuration initiale

1. Créez la racine de session et affichez les règles d’ignorance recommandées (l’état du navigateur reste local) :

   repo-harness chatgpt browser-setup --repo .

2. Rendez résoluble un binaire Oracle épinglé — sur votre PATH ou dans le node_modules/.bin du dépôt. Oracle est un CLI externe optionnel avec sa propre exigence d’exécution (Node ≥ 24), maintenu séparé du runtime Bun de repo-harness.

3. Vérifiez que le moteur est prêt (c’est l’autorité pour la frontière d’exécution d’Oracle) :

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

   Relancez jusqu’à ce qu’il rapporte status: "ready". S’il rapporte nodeCompatible: false, corrigez ou réinstallez d’abord le runtime Node d’Oracle.

Gardez l'état du navigateur hors du contrôle de source

browser-setup affiche les règles d’ignorance pour les profils de navigateur locaux et les jetons de session. Ne les committez jamais, et ne collez jamais de données de session dans des issues, PR ou logs partagés.

2. Exécution à blanc

Validez le prompt, la politique de fichiers, la taille en ligne et le chemin d’écriture de session sans ouvrir ChatGPT. Cela enregistre une session 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. Exécuter une consultation

Oracle est le provider par défaut, donc --provider oracle est optionnel mais montré ici pour plus de clarté.

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

Note

• --model sélectionne le modèle ChatGPT ; --thinking <light|standard|extended|heavy> correspond au temps de réflexion navigateur d’Oracle. Omettez --model pour conserver le modèle actuellement sélectionné dans l’interface connectée.
• Le fichier de réponse écrit fait autorité — stdout/stderr sont traités uniquement comme des logs.
• Une sortie propre qui ne produit aucun fichier de réponse est rapportée comme récupérable (ORACLE_CAPTURE_INCOMPLETE) : le prompt est peut-être déjà soumis, alors rattachez-vous avec browser-followup plutôt que de le renvoyer.
• --write-output doit être relatif au dépôt et n’écrasera pas un fichier existant à moins que --overwrite-output ne soit passé ; les chemins absolus nécessitent le flag réservé à l’humain --allow-absolute-output. Gardez les sorties GPT Pro sous .ai/harness/handoff/gptpro/.

4. Sessions

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

Chaque session est un enregistrement autonome :

• Répertoire.ai/harness/chatgpt/sessions/

  • Répertoire<sessionId>/

    • meta.json métadonnées, horodatages, infos du provider
    • prompt.md le prompt d’entrée
    • transcript.md conversation complète
    • output.md réponse de l’assistant capturée
    • events.jsonl flux d’événements structuré
    • Répertoireartifacts/ artefacts générés optionnels

      • …

5. Suivis et nettoyage

Liez un suivi à une session enregistrée — il reprend cette conversation via Oracle :

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

Le nettoyage est par défaut en exécution à blanc et ne supprime les candidats que lorsque --force est passé :

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

6. Provider natif (déprécié)

Diagnostic uniquement — en cours de retrait

Le provider Chrome DevTools Protocol natif est déprécié. Préférez Oracle. Chrome 136+ bloque aussi les commutateurs de débogage à distance sur votre répertoire de données Chrome par défaut, donc tout usage natif nécessite un --profile-dir non par défaut.

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

Les exécutions natives utilisent le modèle/mode de réflexion déjà sélectionné dans l’interface ChatGPT Web ; passer --model ou --thinking échoue de façon fermée. Utilisez Oracle quand vous avez besoin d’une sélection de modèle côté provider.

7. Exposer via MCP (optionnel)

Les outils navigateur sont désactivés dans MCP par défaut. Activez-les explicitement :

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

Cela expose run_chatgpt_browser_consult, read_chatgpt_browser_session, list_chatgpt_browser_sessions, open_chatgpt_browser_session et continue_chatgpt_browser_session. Les consultations MCP restreignent writeOutput aux artefacts de workflow tels que .ai/harness/handoff/*.md, tasks/reviews/**, .ai/harness/checks/**, plans/prds/** et plans/sprints/**.

Politique de fichiers et sécurité

Le moteur rejette les fichiers refusés avant toute exécution navigateur ou provider, et rejette les liens symboliques de chemin autorisé qui se résolvent en dehors du dépôt.

• Autorisé par défaut : AGENTS.md, CLAUDE.md, README.md, docs/**, plans/**, tasks/**, .ai/context/**, .ai/harness/**, package.json
• Refusé par défaut : .env / .env.*, fichiers de clé privée et de certificat, .ssh/**, .git/**, node_modules/**, dist/**, build/**, coverage/**, secrets/**, credentials/**, private/**, _ops/**, .repo-harness/**/*.json

Notes de sécurité

Gardez les profils de navigateur et la config locale non committés. N’exposez pas le débogage à distance de Chrome hors de localhost sans un plan de sécurité explicite. Faites une exécution à blanc avant d’envoyer un contexte volumineux ou sensible, préférez des fichiers ciblés aux dumps de dépôt entiers, et traitez la sortie ChatGPT générée comme une entrée de revue — et non comme une vérité de code faisant autorité.

Étapes suivantes

Connecteur MCP Exposez les artefacts de workflow à ChatGPT et Codex via MCP.

Planificateur ChatGPT Pro Le workflow de planification et de revue, de bout en bout.