chatgpt-web-handoff: Instructions file for Codex

AGENTS.md

chatgpt-web-handoff AGENTS.md is an instructions file for Codex, OpenCode from sologuy/chatgpt-web-handoff. It costs 2,489 tokens per session, scanned A, original, MIT.

A project guide for a command-line tool that sends an agent’s task context to a logged-in ChatGPT website for separate review and retrieves the structured result.

In plain words
What is it for?
Use it when changing or validating the web-handoff CLI, including its diagnostics, job creation, status handling, submission, and result parsing.
Why use it?
It explains the tool’s boundaries, required reading, browser-based verification, state handling, and rules for keeping credentials and temporary files out of commits.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions CLAUDE.md; mentions Claude Code; mentions AGENTS.md.

This is sologuy/chatgpt-web-handoff's own configuration. It tells Codex and OpenCode how to work on chatgpt-web-handoff itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything chatgpt-web-handoff configures →

Reuse

Borrowing it

Nothing to install: this file belongs to sologuy/chatgpt-web-handoff. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/sologuy/chatgpt-web-handoff/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/sologuy/chatgpt-web-handoff

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for chatgpt-web-handoff AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/sologuy/chatgpt-web-handoff/agents-md/github.svg)](https://agentmods.dev/instructions/sologuy/chatgpt-web-handoff/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/sologuy/chatgpt-web-handoff/agents-md"><img src="https://agentmods.dev/badge/instructions/sologuy/chatgpt-web-handoff/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for chatgpt-web-handoff AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/sologuy/chatgpt-web-handoff/agents-md"><img src="https://agentmods.dev/badge/instructions/sologuy/chatgpt-web-handoff/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,489 This file is loaded in full into every session.
When invoked 2,489 The same file — it is already loaded in full.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.02489 $0.02489
Opus 5.5 $0.00996 $0.00996
Sonnet 5.5 $0.00498 $0.00498
Haiku 4.5 $0.00249 $0.00249

Measured 6d ago against content hash 1d34ee0ff6b7, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

chatgpt-web-handoff AGENTS.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s http://127.0.0.1:9222/json/version | jq -r .Browser
AGENTS.md · 129 lines

How it starts

The opening of the file, as written. The whole thing — 129 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AGENTS.md

给在这个仓库里干活的 AI 编码助手(Claude Code / Codex / DSH 等)看的规则。 CLAUDE.md 通过 @AGENTS.md 导入本文件。全程简体中文。


1. 这是什么

chatgpt-web-handoff(cgh):把编码 agent 当前任务的上下文,交接给 你日常那个 Chrome 里已登录的 ChatGPT Web 做独立审查,再把结构化结论取回本地仓库。

同仓还提供 cgimg:用已登录的 ChatGPT Web 生图,支持参考图并取回本地文件,固定极高档。

形态:两个薄的确定性 CLI(bin/cgh / bin/cgimg)+ 两个可独立安装的 Skill, 共用 cgh_cdp.py 传输、cgh_web.py 页面语义与 cgh_common.py 锁及账本。 不常驻服务、不写浏览器插件、不做 Native Messaging、不自建 Broker、不另起 Chrome Profile。

明确非目标:不做 ChatGPT API 替代品;不做通用浏览器自动化框架; 不做多账号 / 多并发调度;不保存或搬运登录凭证。

2. 改代码前先读

顺序 文件 作用
① 本文件 §6 硬约束,不可违反
② bin/cgh 的模块 docstring 作业目录、job.json 字段、状态机、哨兵格式
③ bin/cgh_web.py 的注释 ChatGPT 真实 UI 的锚点、档位标签、附件行为、后台标签页解冻
④ bin/cgimg / bin/cgh_common.py 生图输出与失败边界、两入口共用锁及账本
⑤ CONTRIBUTING.zh-CN.md 分层边界、怎么验证改动

3. 怎么验证改动

本项目不写单元测试,验证靠真跑——干跑测不出浏览器那一半。

改完 bin/ 里任何东西:

  1. ./bin/cgh doctor 通过
  2. 在一个临时 git 仓库里跑一遍 new / 单活跃拦截 / 状态机 / parse 哨兵解析
  3. 再用 cgh submit 实跑一次低档位作业——这一步不能省
  4. 改动生图或共享层时,真实跑 cgimg 的文字生图与参考图流程,打开输出图片核验,检查失败留页与成功清页

安装改动另跑 ./scripts/install-check.sh,覆盖独立入口、重复安装、冲突零修改及无浏览器/Node 的纯安装。

4. Git

分支 用途
main 默认交付分支,接收已验证改动的合并;里程碑打 tag
dev 日常工作分支
task/<name> 跨多日或有风险的任务

完成的改动必须在验证通过后合并到 main 并推送 origin/main,核对远端 SHA。 开发可以使用 dev 或 task/*,但不能只推任务分支就报告交付完成。 发布时同步更新中英文 README 和仓库描述;打 tag 时使用带说明的 tag,指向 main 的已验证合并提交。

commit 格式:<type>: <中文摘要>,type ∈ docs / feat / fix / chore / design。 提交前 git status --short 审查,确认没有凭证、没有 .env、 没有 .chatgpt/web-handoff/ 作业产物。

5. 目录

目录 职责
bin/ cgh 审查 / cgimg 生图 / cgh_common 锁与账本 / cgh_cdp 传输 / cgh_web ChatGPT 语义
skills/chatgpt-handoff/ 审查 Skill 真相源,相对 CLI 入口指向同仓 bin/cgh
skills/chatgpt-image-gen/ 生图 Skill 真相源,相对 CLI 入口指向同仓 bin/cgimg;不依赖已安装 handoff Skill
templates/handoff/ request.md / followup.md / job.json 模板(运行时依赖)
scripts/ 可选安装与集成验证脚本

Read the full file on GitHub · 129 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago Changed · +18 lines · +636 tokens per session 1d34ee0ff6b7
  2. 2mo ago First seen · 111 lines · 1,853 tokens per session scan A 0bb375847322

Subscribe to this mod's changes

chatgpt-web-handoff AGENTS.md is an instructions file published in the GitHub repository sologuy/chatgpt-web-handoff (2 stars, last pushed 6d ago), licensed MIT. It adds 2,489 tokens to every session, about $0.0100 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,461 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,750 tokens

deno copilot-instructions.md

Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.

denoland/deno · 3,077 tokens