# Migration notes

Migration and deprecation notes for cihai-cli are here, see {ref}`history` as
well.

```{admonition} Before upgrading
1. Pin the package before changing versions.
2. Read the migration notes for the versions you are crossing.
3. Report painful or surprising deprecations on the [tracker].

   API changes can be painful. These notes call out compatibility changes before
   you run into them.

   [tracker]: https://github.com/cihai/cihai-cli/discussions
```

## Next release

_Notes on the upcoming release will be added here_

<!-- Maintainers, insert changes / features for the next release here -->

## cihai-cli 0.15.0 (2022-10-09)

**Completions have changed** (#286)

Completions now use a different tool: [shtab]. See {ref}`completions` for more information.

If you were using earlier versions of cihai-cli (earlier than 0.15.0), you may need to uninstall the old completions, first.

[shtab]: https://docs.iterative.ai/shtab/

<!---
# vim: set filetype=markdown:
-->
