llmx/codex-cli/examples/README.md

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.