fix(cli): show auto-refresh restart guidance after upgrade

CHANGELOG.md

@@ -4,6 +4,8 @@ All notable Darc release changes should be summarized here.
 
 ## Unreleased
 
+- Print post-upgrade auto-refresh restart guidance after `darc upgrade`.
+
 ## [0.2.0] - 2026-05-20
 
 - Add Git-backed encrypted team sharing for selected Darc session context with `darc share`, `darc remote`,

crates/cli/src/tests/upgrade.rs

@@ -147,6 +147,21 @@ fn upgrade_check_json_uses_current_install_command() {
     );
 }
 
+#[test]
+fn post_upgrade_background_refresh_note_bolds_restart_command() {
+    let note = super::post_upgrade_background_refresh_note(HumanStyle::new(
+        true,
+        false,
+        Some("xterm-256color"),
+    ));
+
+    assert!(note.contains("\x1b[1mdarc refresh --auto\x1b[0m"));
+    assert_eq!(
+        strip_ansi_text(&note),
+        "If Darc auto-refresh was running, run darc refresh --auto to restart it with the new version."
+    );
+}
+
 #[test]
 fn upgrade_http_error_detail_is_bounded_and_single_line() {
     let detail = super::upgrade_http_error_detail("  first line\nsecond\tline  ").unwrap();

crates/cli/src/upgrade.rs

@@ -316,11 +316,27 @@ fn run_darc_upgrade(status: UpgradeStatus) -> Result<()> {
         .status()
         .with_context(|| format!("failed to run updater {}", updater_path.display()))?;
     if result.success() {
+        print_post_upgrade_background_refresh_note(style);
         return Ok(());
     }
     bail!("updater exited with status {result}")
 }
 
+/// Prints follow-up guidance for users with a running auto-refresh service.
+fn print_post_upgrade_background_refresh_note(style: HumanStyle) {
+    println!();
+    print_section(style, "Background refresh");
+    print_line(2, post_upgrade_background_refresh_note(style));
+}
+
+/// Formats the post-upgrade auto-refresh restart guidance.
+pub(crate) fn post_upgrade_background_refresh_note(style: HumanStyle) -> String {
+    format!(
+        "If Darc auto-refresh was running, run {} to restart it with the new version.",
+        style.bold("darc refresh --auto")
+    )
+}
+
 /// Checks GitHub Releases for the latest Darc CLI release.
 fn check_darc_upgrade(timeout: Duration, auth: UpgradeCheckAuth) -> Result<UpgradeStatus> {
     let current_version = env!("CARGO_PKG_VERSION").to_owned();