AGENTS.md · git:20260928.0619585 · 2026-09-28 · sha256 d87e3825a105cf32

AGENTS.md git:20260928.0619585A

Immutable. This exact content never changes and is served at /api/v1/blob/d87e3825a105cf32.

# AGENTS.md

This repository is a **Windows-only** Codex Desktop multi-account helper.

- Read `SKILL.md` before changing launch behavior.
- Never commit `auth.json`, backups, or `launch-trace.log`.
- Do not replace the `.cmd` env wrapper with `Start-Process` alone.
- Write `config.toml` without a UTF-8 BOM.
- Run `tests/Run-All.ps1` after script edits.

- Router (`pool` / `stick` / `route` / `depleted`) is opt-in and must stay one-window AuthSwap. Do not add a mux or ChatGPT.exe patcher.
- Layer and ChatGPT Web models stay off by default.

- Humans pick accounts in `Show-CodexAccountApp.ps1` (Codex Accounts) or, when enabled, the Accounts section the in-app switcher adds to the Codex avatar menu (cloned window only). Do not treat PowerShell `route` as the product UI.
- The in-app switcher (`Start-CodexSwitcherHost.ps1` + `switcher-inject.js`) is opt-in, clone-only, loopback CDP only, talks through a CDP binding (no HTTP listener), sends masked emails only, and switches through `Launch-CodexProfile.ps1 -FastSwitch`. Keep page input validated with `ConvertFrom-CodexSwitcherMessage` and keep the injected DOM free of HTML strings.
- The account app must stay PowerShell 5.1 WPF (no extra SDK), reuse CodexRouter.psm1, Hide-AuthEmail, and never Start-Process ChatGPT.exe without the existing .cmd wrapper.