Skip to content

feat: codex app and cli docs - #2668

Merged
marcel-rbro merged 12 commits into
apify:masterfrom
Jakub-Vacek:feat/codex-docs
Jul 23, 2026
Merged

feat: codex app and cli docs#2668
marcel-rbro merged 12 commits into
apify:masterfrom
Jakub-Vacek:feat/codex-docs

Conversation

@Jakub-Vacek

@Jakub-Vacek Jakub-Vacek commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

This PR adds docs for Codex desktop app and Codex CLI. Missing highlights in the images

Already addressed comments from #2673

@Jakub-Vacek
Jakub-Vacek marked this pull request as ready for review July 16, 2026 05:34
@Jakub-Vacek
Jakub-Vacek requested a review from marcel-rbro as a code owner July 16, 2026 05:34

@daveomri daveomri left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

updated images

Comment thread sources/platform/integrations/ai/images/codex-cli/00-plugins-command.png Outdated
Comment thread sources/platform/integrations/ai/images/codex-cli/01-add-marketplace-tab.png Outdated
Comment thread sources/platform/integrations/ai/images/codex-cli/03-plugin-detail.png Outdated
Comment thread sources/platform/integrations/ai/images/codex-cli/04-plugin-install.png Outdated
Comment thread sources/platform/integrations/ai/images/codex-cli/05-test-prompt-input.png Outdated
Comment thread sources/platform/integrations/ai/images/codex/00-plugins.png Outdated
Comment thread sources/platform/integrations/ai/images/codex/01-add-marketplace.png Outdated
Comment thread sources/platform/integrations/ai/images/codex/03-add-plugin.png Outdated
Comment thread sources/platform/integrations/ai/images/codex/04-install-plugin.png Outdated
Comment thread sources/platform/integrations/ai/images/codex/02-marketplace-form.png Outdated
…codex-docs

# Conflicts:
#	sources/platform/integrations/ai/index.mdx
#	sources/platform/integrations/index.mdx

@marcel-rbro marcel-rbro left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few small house-style fixes below (the StoreApify Store, and dropping directional UI references per the writing-style guide). I've left them as suggestions so they're one-click to apply. The main blocker is in a separate top-level comment — the empty screenshot files.

Comment thread sources/platform/integrations/ai/codex/codex-app.md Outdated
Comment thread sources/platform/integrations/ai/codex/codex-app.md Outdated
Comment thread sources/platform/integrations/ai/codex/codex-app.md Outdated
Comment thread sources/platform/integrations/ai/codex/codex-app.md Outdated
Comment thread sources/platform/integrations/ai/codex/codex-cli.md Outdated
Comment thread sources/platform/integrations/ai/codex/codex-cli.md Outdated
Comment thread sources/platform/integrations/ai/codex/codex-cli.md Outdated
@marcel-rbro

Copy link
Copy Markdown
Contributor

Blocker: most of the WebP screenshots are committed as empty (0-byte) files.

10 of the 13 screenshots referenced in codex-app.md and codex-cli.md are 0-byte files (git empty-blob e69de29…), so they'll render blank in the published guides. Only these three contain real image data:

  • images/codex-cli/02-marketplace-repo.webp
  • images/codex-cli/06-test-prompt-output.webp
  • images/codex/05-test-plugin.webp

The empty ones (all currently referenced by image tags):

  • codex-app.md: codex/00-plugins.webp, 01-add-marketplace.webp, 02-marketplace-form.webp, 03-add-plugin.webp, 04-install-plugin.webp
  • codex-cli.md: codex-cli/00-plugins-command.webp, 01-add-marketplace-tab.webp, 03-plugin-detail.webp, 04-plugin-install.webp, 05-test-prompt-input.webp

Heads-up: CI won't catch this — Lint images and Docs build both pass on empty files, so it needs a manual re-commit of the actual WebP binaries for those 10. Could you re-add them (the PNG→WebP conversion itself looks good, no raster files left)? Thanks!

Jakub-Vacek and others added 2 commits July 23, 2026 13:07
Co-authored-by: Marcel Rebro <marcel.rebro@apify.com>
@Jakub-Vacek
Jakub-Vacek requested a review from marcel-rbro July 23, 2026 11:30

@marcel-rbro marcel-rbro left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

L(mostly)GTM 👍 I'll do some structural changes to the pages in the AI section, but let's get it shipped now.

@marcel-rbro
marcel-rbro merged commit 865ca3b into apify:master Jul 23, 2026
15 of 16 checks passed
marcel-rbro added a commit that referenced this pull request Jul 28, 2026
…section (#2803)

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 not added here; each of those PRs adds
its own card. Once this PR merges, those three need a rebase against its
`ai/index.mdx` and `integrations/index.mdx` changes to place their card
in the new AI assistants section.

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

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.

4 participants