convex/Codex-Sites-Convex-Backend-Skill

Build and ship a [ChatGPT Site](https://learn.chatgpt.com/docs/sites?surface=app) with [Convex](https://www.convex.dev/) as its realtime database and backend using one reusable Codex skill.

> **Optional live example:** [Open Daymark Todo](https://daymark-todo.waynesutton.chatgpt.site/). It demonstrates a public, shared realtime list powered by ChatGPT Sites and Convex, with a Convex cron job that clears Todos every five minute

- ChatGPT Sites architecture safeguards - Current Convex documentation routing - Official [Convex agent setup](https://www.convex.dev/agent-setup.md) checks for plugin, MCP, and managed AI files

- Current Convex documentation routing - Official [Convex agent setup](https://www.convex.dev/agent-setup.md) checks for plugin, MCP, and managed AI files - Official Convex component discovery before implementation

- Official [Convex agent setup](https://www.convex.dev/agent-setup.md) checks for plugin, MCP, and managed AI files

- Official Convex component discovery before implementation - Component-specific skill loading when a component is selected - Optional [`convex-helpers`](https://github.com/convex/convex-helpers) discovery for matched code-level utilities

- Component-specific skill loading when a component is selected - Optional [`convex-helpers`](https://github.com/convex/convex-helpers) discovery for matched code-level utilities - Official [Convex ESLint rules](https://docs.convex.dev/esli

- Optional [`convex-helpers`](https://github.com/convex/convex-helpers) discovery for matched code-level utilities

- Official [Convex ESLint rules](https://docs.convex.dev/eslint) for backend quality checks

On the web, open [chatgpt.com/sites](https://chatgpt.com/sites), find the Site, select More actions, then choose Settings or Analytics. The Site stays in this list after the original task or conversation ends.

To run commands yourself, select the terminal icon in the upper-right corner of the Codex app or press `Ctrl` plus the backtick key. The integrated terminal opens for the current project or worktree. Commands such as `npx convex dev` and th

git clone https://github.com/convex/Codex-Sites-Convex-Backend-Skill.git \

mkdir -p .agents/skills git clone https://github.com/convex/Codex-Sites-Convex-Backend-Skill.git \

git clone https://github.com/convex/Codex-Sites-Convex-Backend-Skill.git \

You do not need to open a separate Terminal app or type every command yourself. The recommended beginner path is to ask Codex to run the commands. If you prefer to run them manually, select the terminal icon in the upper-right corner or pre

See the official [Convex Agent Mode documentation](https://docs.convex.dev/cli/agent-mode).

~/.codex/skills/codex-sites-convex/scripts/check-local-url.sh \   http://localhost:3000/ 3000

http://localhost:3000/ 3000

- [Official Convex component catalog](https://www.convex.dev/components/get-convex.md)

- [Convex documentation index for LLMs](https://docs.convex.dev/llms.txt)

The skill treats [`convex-helpers`](https://github.com/convex/convex-helpers) as an optional utility library, not a default dependency or Convex Component. It checks helpers only when a named utility removes repeated code or a known correct

For code quality, new projects use the official [`@convex-dev/eslint-plugin`](https://docs.convex.dev/eslint) recommended rules. Existing ESLint configurations are extended without replacing unrelated rules or silently migrating formats. An

./scripts/check-local-url.sh http://localhost:3000/ 3000

./scripts/check-production-bundle.sh dist \   https://YOUR-PRODUCTION.convex.cloud \

https://YOUR-PRODUCTION.convex.cloud \

https://YOUR-DEVELOPMENT.convex.cloud

Start with the official [Convex agent setup guide](https://www.convex.dev/agent-setup.md). Codex should run applicable setup commands itself and ask you only for approval, authentication, a UI action, or a restart.

- [ChatGPT Sites documentation](https://learn.chatgpt.com/docs/sites?surface=app)

- [Manage Sites in ChatGPT](https://chatgpt.com/sites)

- [OpenAI Academy: ChatGPT Sites](https://openai.com/academy/chatgpt-sites/)

- [Codex overview](https://openai.com/codex/)

- [Codex documentation](https://developers.openai.com/codex/)

- [Codex customization](https://developers.openai.com/codex/concepts/customization)

- [Codex skills](https://developers.openai.com/codex/concepts/customization#skills)

- [AGENTS.md guidance](https://developers.openai.com/codex/concepts/customization#agents-guidance)

- [Codex MCP customization](https://developers.openai.com/codex/concepts/customization#mcp)

- [Codex plugins](https://developers.openai.com/codex/plugins)

- [Codex configuration reference](https://developers.openai.com/codex/config-reference)

- [Node.js release status](https://nodejs.org/en/about/previous-releases)

- [Homebrew `node@24`](https://formulae.brew.sh/formula/node@24)

- [Convex agent setup guide](https://www.convex.dev/agent-setup.md)

- [Using Codex with Convex](https://docs.convex.dev/ai/using-codex)

- [Install the Convex plugin](https://docs.convex.dev/ai/using-codex#install-the-convex-plugin)

- [Convex MCP server](https://docs.convex.dev/ai/convex-mcp-server)

- [Convex Agent Skills](https://docs.convex.dev/ai/agent-skills)

- [Convex Agent Plugins](https://docs.convex.dev/ai/convex-plugins)

- [Convex documentation index for LLMs](https://docs.convex.dev/llms.txt)

- [Official Convex component catalog](https://www.convex.dev/components/get-convex.md)

- [Convex Components directory](https://www.convex.dev/components)

- [Components overview](https://docs.convex.dev/components/overview)

- [Understanding Components](https://docs.convex.dev/components/understanding)

- [Using Components](https://docs.convex.dev/components/using)

- [Authoring Components](https://docs.convex.dev/components/authoring)

- [`convex-helpers`](https://github.com/convex/convex-helpers)

- [`convex-helpers` package](https://www.npmjs.com/package/convex-helpers)

- [Convex ESLint rules](https://docs.convex.dev/eslint)

- [Convex developer documentation](https://docs.convex.dev/)

- [Development workflow](https://docs.convex.dev/understanding/workflow)

- [TypeScript best practices](https://docs.convex.dev/understanding/best-practices/typescript)

- [Convex React client](https://docs.convex.dev/client/react/overview)

- [Configuring deployment URLs](https://docs.convex.dev/client/react/deployment-urls)

- [Realtime](https://docs.convex.dev/realtime)

- [Schemas](https://docs.convex.dev/database/schemas)

- [Indexes](https://docs.convex.dev/database/reading-data/indexes)

- [Pagination](https://docs.convex.dev/database/pagination)

- [Queries](https://docs.convex.dev/functions/query-functions)

- [Mutations](https://docs.convex.dev/functions/mutation-functions)

- [Actions](https://docs.convex.dev/functions/actions)

- [Argument and return validation](https://docs.convex.dev/functions/validation)

- [Internal functions](https://docs.convex.dev/functions/internal-functions)

- [HTTP actions](https://docs.convex.dev/functions/http-actions)

- [Error handling](https://docs.convex.dev/functions/error-handling)

- [Authentication overview](https://docs.convex.dev/auth/overview)

- [Authentication in functions](https://docs.convex.dev/auth/functions-auth)

- [Storing users](https://docs.convex.dev/auth/database-auth)

- [File storage](https://docs.convex.dev/file-storage/overview)

- [Uploading files](https://docs.convex.dev/file-storage/upload-files)

- [Scheduled functions](https://docs.convex.dev/scheduling/scheduled-functions)

- [Cron jobs](https://docs.convex.dev/scheduling/cron-jobs)

- [Full-text search](https://docs.convex.dev/search/text-search)

- [Vector search](https://docs.convex.dev/search/vector-search)

- [Testing](https://docs.convex.dev/testing/overview)

- [Testing the local backend](https://docs.convex.dev/testing/convex-backend)

- [`convex-test`](https://docs.convex.dev/testing/convex-test)

- [Production deployment](https://docs.convex.dev/production/overview)

- [Environment variables](https://docs.convex.dev/production/environment-variables)

- [Project configuration](https://docs.convex.dev/production/project-configuration)

- [Multiple deployments](https://docs.convex.dev/production/multiple-deployments)

- [Usage limits](https://docs.convex.dev/production/usage-limits)

- [Convex CLI](https://docs.convex.dev/cli/overview)

- [`npx convex dev`](https://docs.convex.dev/cli/reference/dev)

- [`npx convex deploy`](https://docs.convex.dev/cli/reference/deploy)

- [`npx convex deployment`](https://docs.convex.dev/cli/reference/deployment)

- [Working with multiple deployments](https://docs.convex.dev/production/multiple-deployments)

- [`npx convex codegen`](https://docs.convex.dev/cli/reference/codegen)

- [`npx convex mcp`](https://docs.convex.dev/cli/reference/mcp)

- [Convex Agent Mode](https://docs.convex.dev/cli/agent-mode)

[github.com/convex/Codex-Sites-Convex-Backend-Skill](https://github.com/convex/Codex-Sites-Convex-Backend-Skill)

- Before selecting a Convex environment or explaining accounts, access, ownership, or authentication, read [references/accounts-access-and-ownership.md](references/accounts-access-and-ownership.md). - Before publishing or changing a publish

- Before publishing or changing a published Site, hosted environment variable, connected Convex deployment, or sharing setting, read [references/sites-settings-and-environment.md](references/sites-settings-and-environment.md). - Before conf

- Before configuring the Convex plugin, MCP, skills, or managed AI files, read the current official [Convex agent setup guide](https://www.convex.dev/agent-setup.md) and [references/bootstrap.md](references/bootstrap.md).

1. Fetch the current official component catalog from `https://www.convex.dev/components/get-convex.md`.

2. Fetch or search the current Convex documentation index at `https://docs.convex.dev/llms.txt`.

Follow https://www.convex.dev/agent-setup.md. Prefer the full official Convex plugin for Codex because it includes skills and MCP. Inspect and verify the marketplace and installed plugin before changing anything. When the plugin succeeds, d

Executable file

<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Codex</title><path d="M19.503 0H4.496A4.496 4.496 0 000 4.496v15.007A4.496 4.496 0 004.496 24h15.007A4.496 4.496 0 0

<svg width="382" height="146" viewBox="0 0 382 146" fill="none" xmlns="http://www.w3.org/2000/svg">

<svg width="382" height="146" viewBox="0 0 382 146" fill="none" xmlns="http://www.w3.org/2000/svg">

- https://docs.convex.dev/cli/agent-mode

- https://docs.convex.dev/cli/local-deployments

- https://docs.convex.dev/production/overview

- https://docs.convex.dev/production/project-configuration

- https://docs.convex.dev/cli/deploy-key-types

- https://docs.convex.dev/llms.txt

Read the current official page before provisioning: https://docs.convex.dev/cli/agent-mode.

For deployment creation, expiration, selection, and scoped tokens, also read https://docs.convex.dev/cli/reference/deployment and https://docs.convex.dev/production/multiple-deployments.

[Credential-related source omitted]

Use only the correct documentation index URL: https://docs.convex.dev/llms.txt.

- https://openai.com/academy/chatgpt-sites/

- https://docs.convex.dev/ai/using-codex

- https://docs.convex.dev/ai/convex-mcp-server

- https://docs.convex.dev/cli/agent-mode

Codex guide: https://learn.chatgpt.com/docs/integrated-terminal

Use https://www.convex.dev/agent-setup.md as the current setup source.

Source: https://docs.convex.dev/ai/using-codex

Agent mode: https://docs.convex.dev/cli/agent-mode

- Display `Built with`, a linked `ChatGPT Sites` label, a `+`, and the Convex logo. - Link ChatGPT Sites to `https://learn.chatgpt.com/docs/sites?surface=app`.

- Link ChatGPT Sites to `https://learn.chatgpt.com/docs/sites?surface=app`.

- Link Convex to `https://www.convex.dev/`.

- Include a repository link to `https://github.com/convex/Codex-Sites-Convex-Backend-Skill` with the Phosphor `GitHubLogoIcon` and the label `ChatGPT Sites + Convex Backend Skill`.

<span>Built with</span>         <a           href="https://learn.chatgpt.com/docs/sites?surface=app"

<a           href="https://learn.chatgpt.com/docs/sites?surface=app"           target="_blank"

href="https://learn.chatgpt.com/docs/sites?surface=app"

<span aria-hidden="true">+</span>         <a           href="https://www.convex.dev/"

<a           href="https://www.convex.dev/"           target="_blank"

href="https://www.convex.dev/"

</a>         <a           href="https://github.com/convex/Codex-Sites-Convex-Backend-Skill"

<a           href="https://github.com/convex/Codex-Sites-Convex-Backend-Skill"           target="_blank"

href="https://github.com/convex/Codex-Sites-Convex-Backend-Skill"

1. Fetch `https://www.convex.dev/components/get-convex.md` for the current official catalog.

2. Search `https://docs.convex.dev/llms.txt` for the equivalent built-in Convex feature and implementation guidance.

- https://www.convex.dev/components/get-convex.md

- https://docs.convex.dev/components/overview

- https://docs.convex.dev/components/using

- https://docs.convex.dev/llms.txt

Use this router instead of loading the full documentation index into context. The complete machine-readable index is https://docs.convex.dev/llms.txt.

Before implementing a capability, also refresh the official component catalog at https://www.convex.dev/components/get-convex.md and follow [components.md](components.md).

| Need | Official documentation | | --- | --- | | React client and provider | https://docs.convex.dev/client/react |

| --- | --- | | React client and provider | https://docs.convex.dev/client/react | | Deployment URLs | https://docs.convex.dev/client/react/deployment-urls |

| React client and provider | https://docs.convex.dev/client/react |

| Deployment URLs | https://docs.convex.dev/client/react/deployment-urls |

| Schema | https://docs.convex.dev/database/schemas |

| Indexes | https://docs.convex.dev/database/reading-data/indexes |

| Pagination | https://docs.convex.dev/database/pagination |

| Queries | https://docs.convex.dev/functions/query-functions |

| Mutations | https://docs.convex.dev/functions/mutation-functions |

| Actions | https://docs.convex.dev/functions/actions |

| Validation | https://docs.convex.dev/functions/validation |

| Authentication overview | https://docs.convex.dev/auth/overview |

| Auth in functions | https://docs.convex.dev/auth/functions-auth |

| File storage | https://docs.convex.dev/file-storage/overview |

| Uploads | https://docs.convex.dev/file-storage/upload-files |

| Scheduled functions | https://docs.convex.dev/scheduling/scheduled-functions |

| Cron jobs | https://docs.convex.dev/scheduling/cron-jobs |

| Full-text search | https://docs.convex.dev/search/text-search |

| Vector search | https://docs.convex.dev/search/vector-search |

| Environment variables | https://docs.convex.dev/production/environment-variables |

| Production deployment | https://docs.convex.dev/production/overview |

| Migrations and schema evolution | https://docs.convex.dev/database/schemas |

| Agent Mode: accountless local and isolated cloud agents | https://docs.convex.dev/cli/agent-mode |

| MCP server | https://docs.convex.dev/ai/convex-mcp-server |

| Codex integration | https://docs.convex.dev/ai/using-codex |

| Components overview | https://docs.convex.dev/components/overview |

| Using components | https://docs.convex.dev/components/using |

| Official component catalog | https://www.convex.dev/components/get-convex.md |

| Convex helper utilities | https://github.com/convex/convex-helpers |

| Convex ESLint rules | https://docs.convex.dev/eslint |

- https://docs.convex.dev/understanding/best-practices/typescript

- https://docs.convex.dev/functions/query-functions

- https://docs.convex.dev/functions/mutation-functions

- https://docs.convex.dev/functions/actions

- https://docs.convex.dev/functions/validation

- https://docs.convex.dev/database/indexes

- https://docs.convex.dev/eslint

- https://github.com/convex/convex-helpers

Open the app folder in Codex, start a task, and paste one complete prompt into the task. Codex runs the commands in its integrated terminal. Users who want to run commands themselves should open the terminal at the project root, the folder 

To manage this Site later, open Sites in ChatGPT or visit https://chatgpt.com/sites, select the Site, then open Settings.

To manage this Site later, open Sites in ChatGPT or visit https://chatgpt.com/sites, select the Site, then open Settings.

To manage this Site later, open Sites in ChatGPT or visit https://chatgpt.com/sites, select the Site, then open Settings.

- https://openai.com/academy/chatgpt-sites/

- https://docs.convex.dev/production/overview

- https://docs.convex.dev/cli/reference/dev

- https://docs.convex.dev/cli/reference/deploy

- https://docs.convex.dev/cli/reference/deployment

- https://docs.convex.dev/production/multiple-deployments

- https://docs.convex.dev/client/react/deployment-urls

- https://docs.convex.dev/ai/convex-mcp-server

- https://docs.convex.dev/cli/agent-mode

1. Inspect `package.json`, the lint script, and all ESLint configuration files. 2. Fetch the current setup instructions at `https://docs.convex.dev/eslint`.

2. Fetch the current setup instructions at `https://docs.convex.dev/eslint`.

- https://github.com/convex/convex-helpers

- https://www.npmjs.com/package/convex-helpers

- https://docs.convex.dev/eslint

- https://www.convex.dev/components/get-convex.md

~/.codex/skills/codex-sites-convex/scripts/check-local-url.sh http://localhost:3000/ 3000

- https://learn.chatgpt.com/docs/sites?surface=app

- https://chatgpt.com/sites

- https://docs.convex.dev/client/react/deployment-urls

- https://docs.convex.dev/production/environment-variables

- https://docs.convex.dev/production/project-configuration

- https://docs.convex.dev/cli/agent-mode

- https://docs.convex.dev/llms.txt

1. Open https://chatgpt.com/sites.

> To manage this Site later, open Sites in ChatGPT or visit https://chatgpt.com/sites, select the Site, then open Settings.

> To manage this Site later, open Sites in ChatGPT or visit https://chatgpt.com/sites, select the Site, then open Settings.

#!/usr/bin/env bash

#!/usr/bin/env bash

query="${*:-}" catalog_url="https://www.convex.dev/components/get-convex.md"

catalog_url="https://www.convex.dev/components/get-convex.md"

trap 'rm -f "$catalog_file"' EXIT

if ! command -v curl >/dev/null 2>&1; then

echo "ERROR: curl is required to refresh the official component catalog"

exit 2 fi if ! curl -L -sS "$catalog_url" -o "$catalog_file"; then

fi if ! curl -L -sS "$catalog_url" -o "$catalog_file"; then   echo "ERROR: could not fetch $catalog_url"

if ! curl -L -sS "$catalog_url" -o "$catalog_file"; then

echo "ERROR: could not fetch $catalog_url"

echo "SOURCE: $catalog_url"

#!/usr/bin/env bash

if [[ ! "$local_url" =~ ^http://(localhost|127\.0\.0\.1):${expected_port}(/|$) ]] &&

[[ ! "$local_url" =~ ^http://\[::1\]:${expected_port}(/|$) ]]; then

if ! command -v curl >/dev/null 2>&1; then

echo "FAILED: curl is required to verify the local HTTP response"

if ! curl --noproxy '*' --fail --silent --show-error --location --max-time 60 "$local_url" >/dev/null; then

#!/usr/bin/env bash

#!/usr/bin/env bash

#!/usr/bin/env bash

#!/usr/bin/env bash

#!/usr/bin/env bash

fi elif [[ -n "$eslint_config" ]]; then   echo "WARNING: $eslint_config exists without @convex-dev/eslint-plugin; follow https://docs.convex.dev/eslint"

elif [[ -n "$eslint_config" ]]; then   echo "WARNING: $eslint_config exists without @convex-dev/eslint-plugin; follow https://docs.convex.dev/eslint" else

echo "WARNING: $eslint_config exists without @convex-dev/eslint-plugin; follow https://docs.convex.dev/eslint"

"current_live_url": null,   "sites_environment_variables": [],   "frontend_convex_url": "http://127.0.0.1:3210"

"sites_environment_variables": [],   "frontend_convex_url": "http://127.0.0.1:3210" }

"frontend_convex_url": "http://127.0.0.1:3210"

#!/usr/bin/env bash

trap 'rm -rf "$temp_dir"' EXIT

printf '#!/usr/bin/env bash\nprintf "%%s\\n" "${!#}" > "$CURL_MARKER"\n' > "$temp_dir/curl" chmod +x "$temp_dir/curl"

marker="$temp_dir/curl-ran" output="$(CURL_MARKER="$marker" PATH="$temp_dir:/usr/bin:/bin" "$url_check" "http://localhost:3000/health" 3000 2>&1)"

output="$(CURL_MARKER="$marker" PATH="$temp_dir:/usr/bin:/bin" "$url_check" "http://localhost:3000/health" 3000 2>&1)"

rm "$marker"

rm "$marker" set +e output="$(CURL_MARKER="$marker" PATH="$temp_dir:/usr/bin:/bin" "$url_check" "http://localhost:3001/" 3000 2>&1)"

set +e output="$(CURL_MARKER="$marker" PATH="$temp_dir:/usr/bin:/bin" "$url_check" "http://localhost:3001/" 3000 2>&1)" status=$?

output="$(CURL_MARKER="$marker" PATH="$temp_dir:/usr/bin:/bin" "$url_check" "http://localhost:3001/" 3000 2>&1)"

#!/usr/bin/env bash

trap 'rm -rf "$temp_dir"' EXIT

Executable file

#!/usr/bin/env bash