Rename format from Codex to CDX (Content-addressed Document eXchange)#35
Merged
Conversation
The format shared the name "Codex" with OpenAI's coding-agent platform, which now dominates developer/AI search and is broadening toward document workflows. Rename to CDX to restore discoverability and a distinct identity. Changes: - Brand/prose: Codex -> CDX; introduce the expansion "Content-addressed Document eXchange" at first mention; drop redundant "CDX Document Format" - Manifest spec-version key: "codex" -> "cdx" - MIME types: application/vnd.codex* -> application/vnd.cdx* - Extension namespace IDs: codex.* -> cdx.* (8 extensions) - Schema $id and $ref host: https://codex.document -> https://cdx.dev - Tooling: generate-template.ts (emits cdx key/IDs) and check-example-coverage.ts (extension-id matcher) updated Intentionally unchanged: the .cdx file extension (already name-independent); the GitHub repo/org name and repo-path URLs (separate admin action; GitHub auto-redirects); package.json name; docs/archive/** (historical record). Validation: schemas compile, all 11 example documents validate, 71/71 cross-references resolve, 8/8 extensions and 15/15 schemas covered. Note: https://cdx.dev is a placeholder schema namespace (JSON Schema $id URIs need not resolve); repoint at a controlled domain if desired.
Post-rename review polish. "CDX document format" redundantly stacked "document" and "format" onto an acronym that already expands to "...Document eXchange". Use "core CDX specification" in the extensions README, and a clean parenthetical expansion in the package description.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Renames the format from Codex to CDX (Content-addressed Document eXchange).
Why: "Codex" now collides with OpenAI's Codex coding-agent platform, which dominates developer/AI search and is broadening toward document workflows — burying this spec's discoverability and blurring its identity. The project predates OpenAI's 2025 relaunch but not their original Codex (2021) or their CODEX trademark, so there is no priority claim; the pragmatic fix is a distinct, neutral format tag. The
.cdxextension already carried no "codex" string, so switching cost is at its minimum now (pre-adoption) and only rises later.Changes
Codex→CDX; expansion "Content-addressed Document eXchange" introduced at first mention; dropped redundant "CDX Document Format" titles"codex"→"cdx"application/vnd.codex*→application/vnd.cdx*codex.*→cdx.*(8 extensions)$id/$refhost:https://codex.document→https://cdx.devgenerate-template.ts(emitscdxkey +cdx.*IDs),check-example-coverage.ts(extension-id matcher)Deliberately unchanged
.cdxfile extension (already name-independent — files in the wild are unaffected)package.jsonname (mirrors the repo)docs/archive/**(historical record)Test plan
tsc --noEmittype checknpm test— schemas compile, 11/11 example documents validate (53 checks)npm run check:sync— all documented types have schema definitionsnpm run check:refs— 71/71 cross-references resolvenpm run check:coverage— 8/8 extensions, 15/15 schemas coveredgenerate-template.tssmoke test emits"cdx": "0.1","id": "cdx.academic",application/vnd.cdx+zipFollow-ups for maintainer
https://cdx.devschema namespace at a domain you control ($idURIs need not resolve — non-blocking)codex-file-format-spec→ e.g.cdx-file-format-spec); GitHub auto-redirects old URLs