From bd6ab8c6654437aeeb7bff18430f1a96323bbac1 Mon Sep 17 00:00:00 2001 From: Thibault Sottiaux Date: Mon, 20 Oct 2025 16:17:07 -0700 Subject: [PATCH] docs: correct getting-started behaviors (#5407) --- docs/getting-started.md | 13 ++----------- 1 file changed, 2 insertions(+), 11 deletions(-) diff --git a/docs/getting-started.md b/docs/getting-started.md index 3473cf53..4930061c 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -43,14 +43,6 @@ You can also run Codex CLI with a prompt as input: codex "explain this codebase to me" ``` -```shell -codex --full-auto "create the fanciest todo-list app" -``` - -That's it - Codex will scaffold a file, run it inside a sandbox, install any -missing dependencies, and show you the live result. Approve the changes and -they'll be committed to your working directory. - ### Example prompts Below are a few bite-size examples you can copy-paste. Replace the text in quotes with your own task. @@ -69,11 +61,10 @@ Looking to reuse your own instructions? Create slash commands with [custom promp ### Memory with AGENTS.md -You can give Codex extra instructions and guidance using `AGENTS.md` files. Codex looks for `AGENTS.md` files in the following places, and merges them top-down: +You can give Codex extra instructions and guidance using `AGENTS.md` files. Codex looks for them in the following places, and merges them top-down: 1. `~/.codex/AGENTS.md` - personal global guidance -2. `AGENTS.md` at repo root - shared project notes -3. `AGENTS.md` in the current working directory - sub-folder/feature specifics +2. Every directory from the repository root down to your current working directory (inclusive). In each directory, Codex first looks for `AGENTS.override.md` and uses it if present; otherwise it falls back to `AGENTS.md`. Use the override form when you want to replace inherited instructions for that directory. For more information on how to use AGENTS.md, see the [official AGENTS.md documentation](https://agents.md/).