# `mix ex_athena.upgrade`
[🔗](https://github.com/udin-io/ex_athena/blob/v0.7.1/lib/mix/tasks/ex_athena.upgrade.ex#L2)

Igniter upgrader task. Invoked automatically by
`mix igniter.upgrade ex_athena` after the dependency is bumped;
can also be invoked directly via `mix ex_athena.upgrade <from> <to>`.

Each migration is keyed by the *target* version and runs only when
the upgrade range crosses that version. See
`Igniter.Upgrades.run/5` for the routing semantics.

## Migrations

  * **`0.4.0`** — informs about the v0.4 breaking change for direct
    callers of the six built-in tools (`Read`, `Edit`, `Bash`,
    `Glob`, `Grep`, `WebFetch`) whose `execute/2` return shape
    changed from `{:ok, text}` to `{:ok, text, ui}`. Loop-driven
    callers are unaffected. Also scaffolds `.exathena/.gitignore`
    so session JSONL logs and the file-history snapshots aren't
    accidentally committed.

---

*Consult [api-reference.md](api-reference.md) for complete listing*