Upgrading

Using the install script

The same install script handles upgrades. If Kyber is already installed, it detects the existing version, upgrades the package, and preserves your config:

curl -fsSL https://kyber.chat/install.sh | bash

It will show:

✓ kyber-chat upgraded (0.9.0 → 1.0.0)
✓ Existing config preserved at ~/.kyber/config.json

The onboarding prompts are skipped entirely on upgrade.

Manual upgrade

Depending on how you installed:

pipx upgrade kyber-chat     # if installed with pipx
uv tool upgrade kyber-chat  # if installed with uv
pip install --upgrade kyber-chat  # if installed with pip

Verify

kyber --version

Notes

Your ~/.kyber/config.json is never overwritten during upgrades
Workspace files (AGENTS.md, SOUL.md, etc.) are not modified
System services (systemd/launchd) may need a restart after upgrading:

# Linux
systemctl --user restart kyber-gateway
systemctl --user restart kyber-dashboard
 
# macOS
launchctl stop chat.kyber.gateway
launchctl start chat.kyber.gateway

Providers Uninstalling