Quickstart

This is the fastest path to a valid end-to-end run.

1) Install

pip install -e .

Optional OpenRouter adapters:

pip install -e ".[openrouter]"

2) Initialize Hexi state in your current folder

hexi init

This creates .hexi/config.toml, .hexi/local.toml, and .hexi/runlog.jsonl.

3) Configure provider and model

hexi onboard

4) Validate setup

hexi doctor

Expected: provider/model detected and key source not none.

5) Run one agent step

hexi run "Add one focused parser edge-case test and run pytest"

6) Inspect output

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

If the run fails, go directly to Troubleshoot Failing Runs.