Initial commit

Signed-off-by: Ilan Bigio <ilan@openai.com>

codex-cli/examples/README.md

@@ -0,0 +1,44 @@
+# Quick start examples
+
+This directory bundles some self‑contained examples using the Codex CLI. If you have never used the Codex CLI before, and want to see it complete a sample task, start with running **camerascii**. You'll see your webcam feed turned into animated ASCII art in a few minutes.
+
+If you want to get started using the Codex CLI directly, skip this and refer to the prompting guide.
+
+## Structure
+
+Each example contains the following:
+```
+example‑name/
+├── run.sh           # helper script that launches a new Codex session for the task
+├── task.yaml        # task spec containing a prompt passed to Codex
+├── template/        # (optional) starter files copied into each run
+└── runs/            # work directories created by run.sh
+```
+
+**run.sh**: a convenience wrapper that does three things:
+- Creates `runs/run_N`, where *N* is the number of a run.
+- Copies the contents of `template/` into that folder (if present).
+- Launches the Codex CLI with the description from `task.yaml`.
+
+**template/**: any existing files or markdown instructions you would like Codex to see before it starts working.
+
+**runs/**: the directories produced by `run.sh`.
+
+## Running an example
+
+1. **Run the helper script**:
+```
+cd camerascii
+./run.sh
+```
+2. **Interact with the Codex CLI**: the CLI will open with the prompt: “*Take a look at the screenshot details and implement a webpage that uses a webcam to style the video feed accordingly…*” Confirm the commands Codex CLI requests to generate `index.html`.
+
+3. **Check its work**: when Codex is done, open ``runs/run_1/index.html`` in a browser.  Your webcam feed should now be rendered as a cascade of ASCII glyphs. If the outcome isn't what you expect, try running it again, or adjust the task prompt.
+
+
+## Other examples
+Besides **camerascii**, you can experiment with:
+
+- **build‑codex‑demo**: recreate the original 2021 Codex YouTube demo.
+- **impossible‑pong**: where Codex creates more difficult levels.
+- **prompt‑analyzer**: make a data science app for clustering [prompts](https://github.com/f/awesome-chatgpt-prompts).