gpt-webcodex: Instructions file for Codex

AGENTS.md

gpt-webcodex AGENTS.md is an instructions file for Codex, OpenCode from 3169657175/gpt-webcodex. It costs 1,363 tokens per session, scanned A, original, MIT.

Maintenance instructions for a Windows Electron desktop assistant that hosts a ChatGPT page, a local MCP runtime, and an OpenAI connection tunnel. MCP is a standard way for an AI assistant to call tools.

In plain words
What is it for?
Use them when modifying the Electron app, its user interface, the local tool runtime, tunnel handling, tests, process restarts, or shared tool definitions.
Why use it?
They help keep the desktop layers, tool schemas, process state, security checks, and recovery behavior consistent during changes.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md.

This is 3169657175/gpt-webcodex's own configuration. It tells Codex and OpenCode how to work on gpt-webcodex 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 gpt-webcodex configures →

Reuse

Borrowing it

Nothing to install: this file belongs to 3169657175/gpt-webcodex. 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/3169657175/gpt-webcodex/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/3169657175/gpt-webcodex

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 gpt-webcodex AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/3169657175/gpt-webcodex/agents-md/github.svg)](https://agentmods.dev/instructions/3169657175/gpt-webcodex/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/3169657175/gpt-webcodex/agents-md"><img src="https://agentmods.dev/badge/instructions/3169657175/gpt-webcodex/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 gpt-webcodex AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/3169657175/gpt-webcodex/agents-md"><img src="https://agentmods.dev/badge/instructions/3169657175/gpt-webcodex/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,363 This file is loaded in full into every session.
When invoked 1,363 The same file — it is already loaded in full.
Security scan A 0 findings. 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.01363 $0.01363
Opus 5.5 $0.00545 $0.00545
Sonnet 5.5 $0.00273 $0.00273
Haiku 4.5 $0.00136 $0.00136

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

Security

Grade A, and why

gpt-webcodex AGENTS.md scanned grade A with 0 findings 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 1mo 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 57 lines

How it starts

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

网页 MCP 助手维护指令

项目目标

  • 这是 Windows Electron 桌面助手,负责承载 ChatGPT 页面、Coding Tools MCP 本地 Runtime 与 OpenAI Tunnel。
  • 优先级顺序:数据安全 > Runtime/Schema 一致性 > 长任务可恢复 > 模型上下文效率 > UI 功能数量。
  • 所有面向用户的界面、状态、错误和操作说明尽量使用中文;协议字段、代码标识符和官方专有名词可保留英文。

关键目录

  • electron/:Electron 主进程、ChatGPT WebContents 与 Runtime/Tunnel 编排。
  • renderer/:桌面管理界面。
  • resources/coding-tools-mcp/:内置 Coding Tools MCP Python Runtime。
  • tests/:Electron/Node 回归测试。
  • resources/coding-tools-mcp/tests/:MCP Runtime Python 回归与场景测试。
  • scripts/check-schema-contract.py:公共 MCP Schema 契约生成与校验。

修改规则

  • 本项目是单用户个人开发助手:桌面 Runtime 固定使用完全权限模式,不依赖聊天过程中的二次批准弹窗。工作区与 authorizedRoots 继续用于工作区选择、直接文件工具的路径解析和范围管理;命令执行本身按用户本机权限运行。
  • 主工作区可能长期存在未提交修改。复杂修改优先使用 run-scoped Git Worktree;应用回主工作区前必须做冲突检查,禁止自动 merge/rebase/reset 用户工作区。
  • 本项目开发必须持续 dogfooding:当 ChatGPT/Agent 在真实调用本 MCP 时发现中断、误判、重复工作、参数易错、状态不清、路径/工作目录不符合直觉等体验问题,应先区分“调用错误 / 可用性缺陷 / Runtime Bug / 回归”,属于工具自身且能低风险修复的,直接补入当前计划、增加回归测试并修复后再继续原阶段;不要把真实使用反馈拖到版本最后统一处理。
  • 不要提交或交付测试生成的 __pycache__ / .pyc 变化。Python 测试应设置 PYTHONDONTWRITEBYTECODE=1。
  • current_command 只表示当前仍在执行的命令。任务进入 completed / failed / cancelled 后必须结算到历史字段并清空当前命令。
  • ChatGPT 页面、OpenAI Tunnel、本地 MCP Runtime 是三个故障层。页面或 Tunnel 异常不得无条件重启健康的 MCP Runtime。
  • Runtime 重启必须确认旧 PID 已退出、端口已释放,并校验新 process_id、launch_id、runtime_instance_id、源码指纹、Schema version/hash 与 workspace。
  • 修改 coding_tools_mcp 任意 Python 运行时代码都必须改变 Runtime source fingerprint;不要恢复成手工文件白名单。

MCP Schema 与模型数据

  • 修改公开工具名、参数、枚举、默认值或含义时,提升 TOOL_SCHEMA_VERSION,然后运行 python scripts/check-schema-contract.py --write 更新 schema-contract.json。
  • server/discover 与健康端点的 Runtime/Schema 身份必须保持一致。
  • ChatGPT 外部调用默认返回 compact model payload;桌面内部调用可以保留 full 数据。不要为了桌面 UI 方便把完整 events、历史 build、巨大 diff、prepared/workspace/task_resume 默认塞回模型上下文。
  • 需要完整调试数据时使用显式 detail=full / response_detail=full,不要把 full 重新设为默认。

版本发布

  • 桌面版本至少同步:package.json、package-lock.json、管理界面版本展示、相关测试与文档。
  • MCP Runtime 版本同步:coding_tools_mcp/__init__.py 与 pyproject.toml。
  • Schema 契约中的 runtime version、schema version、schema hash、tool count 必须由脚本生成并与运行时一致。

Read the full file on GitHub · 57 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. 1mo ago Changed · +11 lines · +491 tokens per session 30012ff10fe9
  2. 2mo ago First seen · 46 lines · 872 tokens per session scan A 402d655bcd31

Subscribe to this mod's changes

gpt-webcodex AGENTS.md is an instructions file published in the GitHub repository 3169657175/gpt-webcodex (276 stars, last pushed 1mo ago), licensed MIT. It adds 1,363 tokens to every session, about $0.0055 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

gpt-webcodex AGENTS.md compared with instructions from other repositories

gpt-webcodex AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
gpt-webcodex AGENTS.md3169657175/gpt-webcodexInstructions file2761mo agoMITA1,363Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode