Skip to content

Upgrading and uninstalling

Keep odette current with one command, or remove it and everything it stored.

Terminal window
odette update --check # is a newer release out?
odette update # download, verify and replace the running binary

odette update needs the gh CLI signed in with access to the releases. It checks the download’s SHA-256 before replacing anything. Release builds exist for darwin/arm64, linux/arm64 and linux/amd64.

If the binary lives somewhere only root can write, such as /usr/local/bin, run sudo odette update. Installing to ~/.local/bin avoids that.

The next launch restarts the background daemon when it is not the binary you now run: a different version, or the same version rebuilt.

Update when no sessions are running. They depend on the daemon, which the restart replaces.

To install by hand instead, follow Install.

Updating Claude Code itself is separate and needs no odette update; see Sessions.

  1. Stop the daemon and remove containers, Claude homes, images and logs:

    Terminal window
    odette daemon stop -y # no question about running sessions
    odette clean # add -n to see what would go, -y to skip the prompt

    odette clean keeps config.json, your profiles and the allowlists.

  2. Remove the data folder, which holds those and everything else odette stored: rm -rf ~/.odette (or your ODETTE_DATA_DIR).

  3. Remove the binary: rm ~/.local/bin/odette (or wherever you put it).

  4. Optionally:

    • delete .odette/ from your projects,
    • delete ~/odette-exchange, a folder sessions share with you,
    • on macOS, remove the odette dashboard certificate from Keychain Access.
Theme