kavi restart
Restart the background daemon for the current session.
Synopsis
kavi restartDescription
Stops the running daemon and starts a fresh one for the current repository session. This is required when the CLI detects a version or protocol mismatch between the client and the running daemon — for example, after upgrading Kavi while a session is active.
When a stale daemon is detected, Kavi blocks mutating actions (queueing tasks, resolving approvals, landing) and displays a "restart required" message. Running kavi restart resolves this.
When to Use
- After upgrading Kavi while a session is running
- When the TUI header shows "restart required"
- When CLI commands fail with a protocol mismatch error
Examples
# Restart the daemon after an upgrade
kavi restart
# Verify the daemon is running with the correct version
kavi statusRelated
- kavi stop -- stop the daemon without restarting
- kavi open -- create a session with the TUI
- kavi resume -- reopen the TUI for a running session