327cf41f0f
More about codespell: https://github.com/codespell-project/codespell . I personally introduced it to dozens if not hundreds of projects already and so far only positive feedback. CI workflow has 'permissions' set only to 'read' so also should be safe. Let me know if just want to take typo fixes in and get rid of the CI --------- Signed-off-by: Yaroslav O. Halchenko <debian@onerussian.com>
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
- Run the helper script:
cd camerascii
./run.sh
-
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. -
Check its work: when Codex is done, open
runs/run_1/index.htmlin 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.