Skip to content

docs: document codex auth bundle + deprecated subscription-only alias#142

Open
Jonnyton wants to merge 2 commits intomainfrom
chore/agents-md-envvars-patch
Open

docs: document codex auth bundle + deprecated subscription-only alias#142
Jonnyton wants to merge 2 commits intomainfrom
chore/agents-md-envvars-patch

Conversation

@Jonnyton
Copy link
Copy Markdown
Owner

@Jonnyton Jonnyton commented May 2, 2026

Summary

  • Closes the remaining AGENTS.md env-vars doc gap from b8d30ac (subscription-only daemon default).
  • Adds 3 rows to §Auth + identity table: WORKFLOW_CODEX_AUTH_JSON_B64, deprecated WORKFLOW_CLOUD_DAEMON_SUBSCRIPTION_ONLY alias, OPENAI_API_KEY strip-at-entrypoint behavior.
  • The canonical WORKFLOW_ALLOW_API_KEY_PROVIDERS + gemini/groq/xai key gating already landed at AGENTS.md L379-L380 in a prior b8d30ac follow-up; this patch closes the remaining hole so operators can re-derive the full auth posture without reading deploy/docker-entrypoint.sh.

Test plan

  • git diff AGENTS.md shows only the 3 intended rows added; no other surface touched.
  • Pre-commit hooks pass: cross-provider drift check clean; skills-valid clean; mojibake scan clean.
  • Reviewer confirms wording matches AGENTS.md style (Var / Purpose / Default columns).
  • Reviewer confirms cross-references to L379-L380 + b8d30ac are accurate.

Jonnyton added 2 commits May 1, 2026 21:20
Closes the AGENTS.md doc-only gap remaining after b8d30ac. Three rows
added to §Auth + identity:

- `WORKFLOW_CODEX_AUTH_JSON_B64` — base64 ~/.codex/auth.json bundle for
  subscription-backed codex auth (decoded by docker-entrypoint.sh).
  Required for codex provider availability under the default
  subscription-only posture.
- `WORKFLOW_CLOUD_DAEMON_SUBSCRIPTION_ONLY` — deprecated legacy alias,
  superseded by `WORKFLOW_ALLOW_API_KEY_PROVIDERS=0` (the canonical
  default already documented at AGENTS.md L379).
- `OPENAI_API_KEY` — stripped at entrypoint unless
  `WORKFLOW_ALLOW_API_KEY_PROVIDERS=1`; the legacy codex
  login --with-api-key path is intentionally not run.

The canonical gate `WORKFLOW_ALLOW_API_KEY_PROVIDERS` and the
GEMINI/GROQ/XAI key gating note already exist at AGENTS.md L379-L380
from a prior b8d30ac follow-up; this patch closes the remaining doc
hole so operators reading the env-vars table can re-derive the full
auth posture without reading docker-entrypoint.sh.
…aceholder, not an alias (verifier follow-up)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant