Codex

Use this guide after Get started.

---

1. Trust project automation

1. Open the Codex TUI in the wired repository.
2. Run /hooks (or your product’s equivalent trust screen).
3. Trust the project’s automation for this repo.

Without trust, Naro will not join the session. This is the most common “nothing happens” cause on Codex.

Confirm codex is on your PATH (codex --version).

2. Daily use

Type the request normally in the TUI, or:

codex "add a coupon field to the cart"

What you should see: a short work summary before implementation runs deep — goal and what must be true before send.

You do not need a special wrapper for daily work.

3. Skip Naro for a quick question

Prefix with ~:

~ explain this function

4. Optional helper for model settings

If your organisation uses Naro’s model catalogue and you want those settings applied for a run, the project may include an optional ./naro helper. That helper is not required for intake or daily typing — only when you intentionally want catalogue model / effort flags.

Compose-only (no agent):

./naro --print "…"

5. When work is finished

Follow Prove & send. Codex will refuse a push while named items remain open.

6. If nothing happens

1. Re-check /hooks trust.
2. Confirm install ran in this repository.
3. See Troubleshooting.