Skip to content

docs: move Codex under the OpenAI hub and add an AI assistants index section#2803

Open
marcel-rbro wants to merge 3 commits into
masterfrom
docs/openai-consolidation
Open

docs: move Codex under the OpenAI hub and add an AI assistants index section#2803
marcel-rbro wants to merge 3 commits into
masterfrom
docs/openai-consolidation

Conversation

@marcel-rbro

@marcel-rbro marcel-rbro commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #2668, plus an AI-index cleanup. Two related changes:

1. Codex → OpenAI hub. Codex is an OpenAI product, so its docs move under the OpenAI hub (/integrations/openai) next to ChatGPT, the Agents SDK, and Assistants - mirroring how Claude Code sits under the Claude hub. Drops the standalone Codex hub. The desktop page is renamed to OpenAI's current naming, "Codex in the ChatGPT desktop app" (Codex is now a mode in the ChatGPT desktop app, not a standalone "Codex app"). Page slugs are unchanged (/integrations/codex-app, /integrations/codex-cli), so no redirects are needed.

2. AI index restructure. Adds a dedicated AI assistants section (ChatGPT, Claude Desktop, Claude Code CLI, Codex desktop + CLI, Cursor) and trims By provider to the OpenAI and Claude hub links.

Files: move codex/* under openai/, delete the Codex hub + _category_.yml, update openai/index.mdx (Codex cards), ai/index.mdx (assistants section + trim), and repoint the featured card in integrations/index.mdx. pnpm build passes (onBrokenLinks: throw).

Cards for the in-review assistants - GitHub Copilot (#2699), Grok Build (#2700), OpenCode (#2692) - are staged as a commented block with final markup. Those PRs are currently held pending their plugins going public; uncomment each card when its page merges. On merge they also need a keep-both rebase against this PR's ai/index.mdx changes.

Draft - open decision: whether to also handle the OpenAI Assistants deprecation (#2329) here.

🤖 Generated with Claude Code

Move the Codex pages under the OpenAI integrations hub (Codex is an OpenAI
product) and rename the desktop page to OpenAI's current naming ("Codex in
the ChatGPT desktop app"). Updates the OpenAI hub, both integration card
grids, and adds redirects for the old Codex slugs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added the t-docs Issues owned by technical writing team. label Jul 23, 2026
@apify-service-account

apify-service-account commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

✅ Preview for this PR (commit b2f60829) is ready at https://pr-2803.preview.docs.apify.com (see action run).

marcel-rbro and others added 2 commits July 23, 2026 15:39
Revert the desktop page slug to /integrations/codex-app (filename back to
codex-app.md) and remove the nginx redirects - the slugs are unchanged so
no redirect is needed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Group chat and coding assistants (ChatGPT, Claude Desktop, Claude Code CLI,
Codex desktop + CLI, Cursor) into a dedicated section on the AI index, and
stage cards for the in-review Copilot/Grok/OpenCode pages as comments so they
activate when those PRs merge. Trim "By provider" to the OpenAI and Claude
hub links.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@marcel-rbro marcel-rbro changed the title docs: consolidate Codex docs under the OpenAI hub docs: move Codex under the OpenAI hub and add an AI assistants index section Jul 23, 2026
@marcel-rbro
marcel-rbro marked this pull request as ready for review July 23, 2026 14:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

t-docs Issues owned by technical writing team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants