## Migration Notes

Owlen is still in alpha, so configuration and storage formats may change between releases. This directory collects short guides that explain how to update a local environment when breaking changes land.

### Schema 1.1.0 (October 2025)

Owlen `config.toml` files now carry a `schema_version`. On startup the loader upgrades any existing file and warns when deprecated keys are present. No manual changes are required, but if you track the file in version control you may notice `schema_version = "1.1.0"` added near the top.

If you previously set `agent.max_tool_calls`, replace it with `agent.max_iterations`. The former is now ignored.