Skip to content

[docs-scanner] Confusing prerequisite in ChatGPT sandbox integration #25648

Description

@docker-agent

File: content/manuals/ai/sandboxes/integrations/chatgpt.md

Issue

The Prerequisites section lists a requirement that creates a circular dependency:

An existing sandbox created from the Codex template. The template includes
the codex command required by the app's remote server.

But then the very next section (Connect) shows how to create this sandbox:

$ sbx create --name demo codex .

This is confusing because:

  1. It's listed as a prerequisite, but the instructions immediately show how to create it
  2. The term "Codex template" is undefined - readers don't know what this means or how it differs from other sandbox types
  3. It creates a circular flow: "you need X to proceed" → "here's how to create X"

Why this matters

A reader following these instructions would be confused about whether they need to do something before starting, or whether the Connect section is the actual starting point. The prerequisite implies they should already have a Codex sandbox, but the Connect section treats it as the first step.

Suggested fix

Either:

Option 1: Remove this from Prerequisites since the Connect section shows how to create it:

## Prerequisites

- SSH access set up. See [Editor and app integrations](_index.md#enable-ssh-access).
- The ChatGPT desktop app installed.

Option 2: Reframe it as informational rather than a prerequisite:

## Prerequisites

- SSH access set up. See [Editor and app integrations](_index.md#enable-ssh-access).
- The ChatGPT desktop app installed.

> [!NOTE]
> ChatGPT requires a sandbox running the Codex agent, which includes the
> `codex` command needed by the app's remote server. The Connect section
> shows how to create one.

Found by nightly documentation quality scanner

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/aistatus/confirmedIssue triaged and confirmed as a real problem, ready to fix

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions