First Successful Run

This walkthrough is a stricter "first real run" with explicit checks.

Goal

Produce a small, reviewable code change and verify events are complete.

Steps

1. Create a branch:

git checkout -b codex/hexi-first-run

1. Confirm setup:

hexi doctor

1. Run a narrow task:

hexi run "Only edit tests/test_parser.py to add empty-input coverage; run pytest tests/test_parser.py"

1. Validate results:

hexi diff
tail -n 100 .hexi/runlog.jsonl

Success criteria

• Diff is small and understandable.
• Runlog includes progress, review, and terminal done.
• No unexpected file edits outside requested scope.

If not successful

Use Action Plans plus hexi plan-check and hexi apply for deterministic troubleshooting.