Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

feat(config): show deprecation details on every command (#2171)

Maximilian Roosc76deb45ad10
diff --git a/src/commands/config/show.rs b/src/commands/config/show.rs
index e38d9660b..76e207b94 100644
--- a/src/commands/config/show.rs
+++ b/src/commands/config/show.rs
@@ -509,7 +509,7 @@ fn render_user_config(out: &mut String, has_system_config: bool) -> anyhow::Resu
return Ok(());
}
- // Check for deprecations with show_brief_warning=false (silent mode)
+ // Check for deprecations with emit_inline_warnings=false (silent mode)
// User config is global, not tied to any repository
let has_deprecations = if let Ok(result) = worktrunk::config::check_and_migrate(
&config_path,
@@ -657,7 +657,7 @@ fn render_project_config(out: &mut String) -> anyhow::Result<()> {
return Ok(());
}
- // Check for deprecations with show_brief_warning=false (silent mode)
+ // Check for deprecations with emit_inline_warnings=false (silent mode)
// Only write migration file in main worktree, not linked worktrees
let is_main_worktree = !repo.current_worktree().is_linked().unwrap_or(true);
let has_deprecations = if let Ok(result) = worktrunk::config::check_and_migrate(
diff --git a/src/commands/config/update.rs b/src/commands/config/update.rs
index bd49f7158..074dd7ad3 100644
--- a/src/commands/config/update.rs
+++ b/src/commands/config/update.rs
@@ -111,7 +111,7 @@ fn check_user_config() -> anyhow::Result<Option<UpdateCandidate>> {
let content = std::fs::read_to_string(&config_path).context("Failed to read user config")?;
- // Use check_and_migrate in silent mode (show_brief_warning=false) which:
+ // Use check_and_migrate in silent mode (emit_inline_warnings=false) which:
// - Detects deprecations
// - Copies approved-commands to approvals.toml
// - Writes the .new migration file
diff --git a/src/config/deprecation.rs b/src/config/deprecation.rs
index 9ea5a5953..cbb3d162f 100644
--- a/src/config/deprecation.rs
+++ b/src/config/deprecation.rs
@@ -39,6 +39,10 @@ use crate::styling::{
static WARNED_DEPRECATED_PATHS: LazyLock<Mutex<HashSet<PathBuf>>> =
LazyLock::new(|| Mutex::new(HashSet::new()));
+/// Set once the "Run wt config show..." hint has been emitted this process,
+/// so multiple deprecated configs (user + project) share a single hint line.
+static DEPRECATION_HINT_EMITTED: OnceLock<()> = OnceLock::new();
+
/// Latch that silences config deprecation/unknown-field warnings for the rest
/// of the process. Set by shell completion and picker paths, where stderr
/// output would appear above the user's prompt or TUI.
@@ -1120,8 +1124,9 @@ fn migration_path(path: &Path) -> PathBuf {
/// (global, not repo-specific), pass `None` and the function will check if the `.new`
/// file already exists instead.
///
-/// When `show_brief_warning` is true, only a brief pointer to `wt config show` is emitted
-/// instead of full deprecation details. Use this for commands other than `config show`.
+/// When `emit_inline_warnings` is true, per-kind deprecation warnings are printed to stderr
+/// with a hint pointing at `wt config show`/`wt config update`. When false, nothing is
+/// printed and the caller is expected to render via `format_deprecation_details`. Use this for commands other than `config show`.
///
/// Warnings are deduplicated per path per process.
///
@@ -1133,7 +1138,7 @@ pub fn check_and_migrate(
warn_and_migrate: bool,
label: &str,
repo: Option<&crate::git::Repository>,
- show_brief_warning: bool,
+ emit_inline_warnings: bool,
) -> anyhow::Result<CheckAndMigrateResult> {
// Parse once — shared by detection and migration
let (deprecations, migrated_content, template_strings) =
@@ -1164,11 +1169,11 @@ pub fn check_and_migrate(
let new_path = migration_path(path);
- // Skip writing if: (a) this is a brief warning (not `wt config show`), AND
+ // Skip writing if: (a) caller emits inline (not `wt config show`), AND
// (b) migration file already exists
// This means first-time deprecation gets automatic file write, after that
// users run `wt config show` to get/update the migration file.
- let should_skip_write = show_brief_warning && new_path.exists();
+ let should_skip_write = emit_inline_warnings && new_path.exists();
// Build deprecation info for return
let mut info = DeprecationInfo {
@@ -1219,10 +1224,19 @@ pub fn check_and_migrate(
info.approvals_copied_to = copy_approved_commands_to_approvals_file(path);
}
- // For brief warnings (non-config-show commands), just show a pointer
- if show_brief_warning {
+ // For non-config-show commands, emit per-kind warnings but skip the diff.
+ // The diff is reserved for `wt config show`, where the user has opted into details.
+ if emit_inline_warnings {
if SUPPRESS_WARNINGS.get().is_none() {
- eprintln!("{}", format_brief_warning(label));
+ eprint!("{}", format_deprecation_warnings(&info));
+ if DEPRECATION_HINT_EMITTED.set(()).is_ok() {
+ eprintln!(
+ "{}",
+ hint_message(cformat!(
+ "To see details, run <underline>wt config show</>; to apply updates, run <underline>wt config update</>"
+ ))
+ );
+ }
if let Some(approvals_path) = &info.approvals_copied_to {
let approvals_filename = approvals_path
@@ -1265,18 +1279,6 @@ pub fn check_and_migrate(
})
}
-/// Format brief warning for normal config loading.
-///
-/// Returns a formatted warning string. Does not print anything;
-/// caller is responsible for output.
-pub fn format_brief_warning(label: &str) -> String {
- warning_message(cformat!(
- "{} has deprecated settings. Run <bold>wt config show</> for details or <bold>wt config update</> to apply updates",
- label
- ))
- .to_string()
-}
-
/// Write migration file with all fixes applied.
///
/// Applies all deprecation fixes (variable renames, section migrations) and writes
@@ -1491,7 +1493,10 @@ pub fn format_deprecation_warnings(info: &DeprecationInfo) -> String {
out,
"{}",
warning_message(cformat!(
- "{}: table form for {} is deprecated in favor of the pipeline form",
+ "{}: table form for {} is deprecated in favor of the pipeline form. \
+ We're unifying pre-hooks, post-hooks, and aliases so that list form always runs serially \
+ and table form always runs in parallel — migrate now to keep the current serial behavior \
+ once the table form is repurposed.",
info.label,
hook_list
))
diff --git a/src/config/mod.rs b/src/config/mod.rs
index 7449176d8..7da1c1bc9 100644
--- a/src/config/mod.rs
+++ b/src/config/mod.rs
@@ -101,7 +101,6 @@ pub use deprecation::DeprecationInfo;
pub use deprecation::Deprecations;
pub use deprecation::check_and_migrate;
pub use deprecation::detect_deprecations;
-pub use deprecation::format_brief_warning;
pub use deprecation::format_deprecation_details;
pub use deprecation::format_deprecation_warnings;
pub use deprecation::format_migration_diff;
diff --git a/src/config/project.rs b/src/config/project.rs
index f31f53559..ccab011e1 100644
--- a/src/config/project.rs
+++ b/src/config/project.rs
@@ -210,7 +210,7 @@ impl ProjectConfig {
// Check for deprecated template variables and create migration file if needed
// Only write migration file in main worktree, not linked worktrees
- // Use show_brief_warning=true to emit a brief pointer to `wt config show`
+ // emit_inline_warnings=true: print per-kind warnings inline during config load
let is_main_worktree = !repo.current_worktree().is_linked().unwrap_or(true);
let repo_for_hints = if write_hints { Some(repo) } else { None };
let _ = super::deprecation::check_and_migrate(
@@ -219,7 +219,7 @@ impl ProjectConfig {
is_main_worktree,
"Project config",
repo_for_hints,
- true, // show_brief_warning
+ true, // emit_inline_warnings
);
// Warn about unknown fields (only in main worktree where it's actionable)
diff --git a/tests/integration_tests/config_show.rs b/tests/integration_tests/config_show.rs
index 3162629c9..8814f0935 100644
--- a/tests/integration_tests/config_show.rs
+++ b/tests/integration_tests/config_show.rs
@@ -1685,8 +1685,8 @@ fn test_deprecated_template_variables_hint_deduplication(repo: TestRepo, temp_ho
stderr
);
assert!(
- stderr.contains("deprecated settings"),
- "Second run should show brief warning, got: {stderr}"
+ stderr.contains("is deprecated"),
+ "Second run should show deprecation warning, got: {stderr}"
);
assert!(
!stderr.contains("Wrote migrated"),
@@ -1886,7 +1886,7 @@ fn test_fixing_deprecated_config_clears_hint_for_future_deprecations(
assert!(output.status.success());
let stderr = String::from_utf8_lossy(&output.stderr);
assert!(
- stderr.contains("deprecated settings"),
+ stderr.contains("is deprecated"),
"New deprecation should show warning, got: {stderr}"
);
}
@@ -2004,10 +2004,10 @@ fn test_user_config_deprecated_variables_deduplication(repo: TestRepo, temp_home
"Second run should succeed: {:?}",
stderr
);
- // Should show brief warning (deprecated settings) but NOT write file
+ // Should still show deprecation warning but NOT write file
assert!(
- stderr.contains("User config has deprecated settings"),
- "Second run should show brief warning, got: {stderr}"
+ stderr.contains("User config:") && stderr.contains("is deprecated"),
+ "Second run should show deprecation warning, got: {stderr}"
);
assert!(
!stderr.contains("Wrote migrated"),
diff --git a/tests/snapshots/integration__integration_tests__approval_ui__already_approved_skip_prompt.snap b/tests/snapshots/integration__integration_tests__approval_ui__already_approved_skip_prompt.snap
index 2983cce52..21bb4c148 100644
--- a/tests/snapshots/integration__integration_tests__approval_ui__already_approved_skip_prompt.snap
+++ b/tests/snapshots/integration__integration_tests__approval_ui__already_approved_skip_prompt.snap
@@ -45,7 +45,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start project hook @ _REPO_.test-approved
  echo 'approved' > output.txt
✓ Created branch test-approved from main and worktree @ _REPO_.test-approved
diff --git a/tests/snapshots/integration__integration_tests__approval_ui__approval_fails_in_non_tty.snap b/tests/snapshots/integration__integration_tests__approval_ui__approval_fails_in_non_tty.snap
index 8f8783c2a..198691364 100644
--- a/tests/snapshots/integration__integration_tests__approval_ui__approval_fails_in_non_tty.snap
+++ b/tests/snapshots/integration__integration_tests__approval_ui__approval_fails_in_non_tty.snap
@@ -45,7 +45,8 @@ exit_code: 1
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
▲ origin needs approval to execute 1 command:
○ pre-start:
  echo 'test command'
diff --git a/tests/snapshots/integration__integration_tests__approval_ui__approval_mixed_approved_unapproved.snap b/tests/snapshots/integration__integration_tests__approval_ui__approval_mixed_approved_unapproved.snap
index 379e8cef4..f310ede7d 100644
--- a/tests/snapshots/integration__integration_tests__approval_ui__approval_mixed_approved_unapproved.snap
+++ b/tests/snapshots/integration__integration_tests__approval_ui__approval_mixed_approved_unapproved.snap
@@ -6,7 +6,8 @@ exit_code: 1
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
▲ repo needs approval to execute 2 commands:
○ pre-start first:
  echo 'First command'
diff --git a/tests/snapshots/integration__integration_tests__approval_ui__approval_multiple_commands.snap b/tests/snapshots/integration__integration_tests__approval_ui__approval_multiple_commands.snap
index c2336f457..5b7243553 100644
--- a/tests/snapshots/integration__integration_tests__approval_ui__approval_multiple_commands.snap
+++ b/tests/snapshots/integration__integration_tests__approval_ui__approval_multiple_commands.snap
@@ -6,7 +6,8 @@ exit_code: 1
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
▲ origin needs approval to execute 4 commands:
○ pre-start branch:
  echo 'Branch: {{ branch }}'
diff --git a/tests/snapshots/integration__integration_tests__approval_ui__approval_named_commands.snap b/tests/snapshots/integration__integration_tests__approval_ui__approval_named_commands.snap
index d6b2500bb..9c98dbe86 100644
--- a/tests/snapshots/integration__integration_tests__approval_ui__approval_named_commands.snap
+++ b/tests/snapshots/integration__integration_tests__approval_ui__approval_named_commands.snap
@@ -6,7 +6,8 @@ exit_code: 1
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
▲ origin needs approval to execute 3 commands:
○ pre-start install:
  echo 'Installing dependencies...'
diff --git a/tests/snapshots/integration__integration_tests__approval_ui__approval_single_command.snap b/tests/snapshots/integration__integration_tests__approval_ui__approval_single_command.snap
index 61859228c..c5281a691 100644
--- a/tests/snapshots/integration__integration_tests__approval_ui__approval_single_command.snap
+++ b/tests/snapshots/integration__integration_tests__approval_ui__approval_single_command.snap
@@ -6,7 +6,8 @@ exit_code: 1
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
▲ origin needs approval to execute 1 command:
○ pre-start:
  echo 'Worktree path: {{ worktree_path }}'
diff --git a/tests/snapshots/integration__integration_tests__approval_ui__decline_approval_skips_only_unapproved.snap b/tests/snapshots/integration__integration_tests__approval_ui__decline_approval_skips_only_unapproved.snap
index 379e8cef4..f310ede7d 100644
--- a/tests/snapshots/integration__integration_tests__approval_ui__decline_approval_skips_only_unapproved.snap
+++ b/tests/snapshots/integration__integration_tests__approval_ui__decline_approval_skips_only_unapproved.snap
@@ -6,7 +6,8 @@ exit_code: 1
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
▲ repo needs approval to execute 2 commands:
○ pre-start first:
  echo 'First command'
diff --git a/tests/snapshots/integration__integration_tests__approval_ui__yes_bypasses_tty_check.snap b/tests/snapshots/integration__integration_tests__approval_ui__yes_bypasses_tty_check.snap
index 84c542a06..8e0d83bd4 100644
--- a/tests/snapshots/integration__integration_tests__approval_ui__yes_bypasses_tty_check.snap
+++ b/tests/snapshots/integration__integration_tests__approval_ui__yes_bypasses_tty_check.snap
@@ -46,7 +46,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start project hook @ _REPO_.test-yes-tty
  echo 'test command'
test command
diff --git a/tests/snapshots/integration__integration_tests__approval_ui__yes_does_not_save_approvals_first_run.snap b/tests/snapshots/integration__integration_tests__approval_ui__yes_does_not_save_approvals_first_run.snap
index 372105e17..0c1f583d4 100644
--- a/tests/snapshots/integration__integration_tests__approval_ui__yes_does_not_save_approvals_first_run.snap
+++ b/tests/snapshots/integration__integration_tests__approval_ui__yes_does_not_save_approvals_first_run.snap
@@ -46,7 +46,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start project hook @ _REPO_.test-yes
  echo 'test command' > output.txt
✓ Created branch test-yes from main and worktree @ _REPO_.test-yes
diff --git a/tests/snapshots/integration__integration_tests__approval_ui__yes_does_not_save_approvals_second_run.snap b/tests/snapshots/integration__integration_tests__approval_ui__yes_does_not_save_approvals_second_run.snap
index 7533c3914..5e6cac186 100644
--- a/tests/snapshots/integration__integration_tests__approval_ui__yes_does_not_save_approvals_second_run.snap
+++ b/tests/snapshots/integration__integration_tests__approval_ui__yes_does_not_save_approvals_second_run.snap
@@ -6,7 +6,8 @@ exit_code: 1
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
▲ origin needs approval to execute 1 command:
○ pre-start:
  echo 'test command' > output.txt
diff --git a/tests/snapshots/integration__integration_tests__approvals__add_approvals_all_already_approved.snap b/tests/snapshots/integration__integration_tests__approvals__add_approvals_all_already_approved.snap
index 44df388fd..b2d68cd26 100644
--- a/tests/snapshots/integration__integration_tests__approvals__add_approvals_all_already_approved.snap
+++ b/tests/snapshots/integration__integration_tests__approvals__add_approvals_all_already_approved.snap
@@ -45,7 +45,8 @@ exit_code: 1
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
▲ origin needs approval to execute 1 command:
○ pre-start:
  echo 'test'
diff --git a/tests/snapshots/integration__integration_tests__approvals__add_approvals_all_none_approved.snap b/tests/snapshots/integration__integration_tests__approvals__add_approvals_all_none_approved.snap
index 029af4a44..2badafd42 100644
--- a/tests/snapshots/integration__integration_tests__approvals__add_approvals_all_none_approved.snap
+++ b/tests/snapshots/integration__integration_tests__approvals__add_approvals_all_none_approved.snap
@@ -46,7 +46,8 @@ exit_code: 1
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
▲ origin needs approval to execute 1 command:
○ pre-start:
  echo 'test'
diff --git a/tests/snapshots/integration__integration_tests__ci_status__list_full_with_invalid_platform_override.snap b/tests/snapshots/integration__integration_tests__ci_status__list_full_with_invalid_platform_override.snap
index 83a8635ec..87ed7cd21 100644
--- a/tests/snapshots/integration__integration_tests__ci_status__list_full_with_invalid_platform_override.snap
+++ b/tests/snapshots/integration__integration_tests__ci_status__list_full_with_invalid_platform_override.snap
@@ -52,7 +52,8 @@ exit_code: 0
○ Showing 5 worktrees, 1 with changes, 3 ahead
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: [ci] is deprecated in favor of [forge]
+↳ To see details, run wt config show; to apply updates, run wt config update
[W] Invalid CI platform in config: 'invalid_platform'. Expected 'github' or 'gitlab'.
[W] Invalid CI platform in config: 'invalid_platform'. Expected 'github' or 'gitlab'.
[W] Invalid CI platform in config: 'invalid_platform'. Expected 'github' or 'gitlab'.
diff --git a/tests/snapshots/integration__integration_tests__ci_status__list_full_with_platform_override_github.snap b/tests/snapshots/integration__integration_tests__ci_status__list_full_with_platform_override_github.snap
index 3bfb6cbe0..8b2ae0b9b 100644
--- a/tests/snapshots/integration__integration_tests__ci_status__list_full_with_platform_override_github.snap
+++ b/tests/snapshots/integration__integration_tests__ci_status__list_full_with_platform_override_github.snap
@@ -52,4 +52,5 @@ exit_code: 0
○ Showing 5 worktrees, 1 with changes, 3 ahead
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: [ci] is deprecated in favor of [forge]
+↳ To see details, run wt config show; to apply updates, run wt config update
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_displays_pre_hook_table_form_deprecation.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_displays_pre_hook_table_form_deprecation.snap
index e9d32f537..3533462cc 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_displays_pre_hook_table_form_deprecation.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_displays_pre_hook_table_form_deprecation.snap
@@ -46,7 +46,7 @@ exit_code: 0
↳ Not found; to create one, run wt config create
PROJECT CONFIG @ _REPO_/.config/wt.toml
-▲ Project config: table form for pre-start, pre-merge is deprecated in favor of the pipeline form
+▲ Project config: table form for pre-start, pre-merge is deprecated in favor of the pipeline form. We're unifying pre-hooks, post-hooks, and aliases so that list form always runs serially and table form always runs in parallel — migrate now to keep the current serial behavior once the table form is repurposed.
↳ To apply: wt config update
○ Proposed diff:
  diff --git a_REPO_/.config/wt.toml b_REPO_/.config/wt.toml.new
diff --git a/tests/snapshots/integration__integration_tests__config_show__deprecated_approved_commands_copies_to_approvals_file.snap b/tests/snapshots/integration__integration_tests__config_show__deprecated_approved_commands_copies_to_approvals_file.snap
index 1530faa52..b96baa7f8 100644
--- a/tests/snapshots/integration__integration_tests__config_show__deprecated_approved_commands_copies_to_approvals_file.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__deprecated_approved_commands_copies_to_approvals_file.snap
@@ -50,5 +50,7 @@ exit_code: 0
○ Showing 4 worktrees, 3 ahead
----- stderr -----
-▲ User config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ User config: approved-commands under [projects] is deprecated in favor of approvals.toml
+↳ Copied approved commands to approvals.toml
+↳ To see details, run wt config show; to apply updates, run wt config update
↳ Copied approved commands to approvals.toml
diff --git a/tests/snapshots/integration__integration_tests__config_show__deprecated_commit_generation_project_level_shows_warning.snap b/tests/snapshots/integration__integration_tests__config_show__deprecated_commit_generation_project_level_shows_warning.snap
index c407c71bb..abc4b4578 100644
--- a/tests/snapshots/integration__integration_tests__config_show__deprecated_commit_generation_project_level_shows_warning.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__deprecated_commit_generation_project_level_shows_warning.snap
@@ -50,4 +50,5 @@ exit_code: 0
○ Showing 4 worktrees, 3 ahead
----- stderr -----
-▲ User config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ User config: [projects."github.com/example/repo".commit-generation] is deprecated in favor of [projects."github.com/example/repo".commit.generation]
+↳ To see details, run wt config show; to apply updates, run wt config update
diff --git a/tests/snapshots/integration__integration_tests__config_show__deprecated_commit_generation_section_shows_warning.snap b/tests/snapshots/integration__integration_tests__config_show__deprecated_commit_generation_section_shows_warning.snap
index c407c71bb..0c7366668 100644
--- a/tests/snapshots/integration__integration_tests__config_show__deprecated_commit_generation_section_shows_warning.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__deprecated_commit_generation_section_shows_warning.snap
@@ -50,4 +50,5 @@ exit_code: 0
○ Showing 4 worktrees, 3 ahead
----- stderr -----
-▲ User config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ User config: [commit-generation] is deprecated in favor of [commit.generation]
+↳ To see details, run wt config show; to apply updates, run wt config update
diff --git a/tests/snapshots/integration__integration_tests__config_show__deprecated_template_variables_show_warning.snap b/tests/snapshots/integration__integration_tests__config_show__deprecated_template_variables_show_warning.snap
index c407c71bb..b2d66702f 100644
--- a/tests/snapshots/integration__integration_tests__config_show__deprecated_template_variables_show_warning.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__deprecated_template_variables_show_warning.snap
@@ -50,4 +50,8 @@ exit_code: 0
○ Showing 4 worktrees, 3 ahead
----- stderr -----
-▲ User config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ User config: template variable repo_root is deprecated in favor of repo_path
+▲ User config: template variable worktree is deprecated in favor of worktree_path
+▲ User config: template variable main_worktree is deprecated in favor of repo
+▲ User config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
diff --git a/tests/snapshots/integration__integration_tests__config_show__deprecated_template_variables_verbose_shows_content.snap b/tests/snapshots/integration__integration_tests__config_show__deprecated_template_variables_verbose_shows_content.snap
index ca4d80389..74d9f77f6 100644
--- a/tests/snapshots/integration__integration_tests__config_show__deprecated_template_variables_verbose_shows_content.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__deprecated_template_variables_verbose_shows_content.snap
@@ -51,7 +51,11 @@ exit_code: 0
○ Showing 4 worktrees, 3 ahead
----- stderr -----
-▲ User config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ User config: template variable repo_root is deprecated in favor of repo_path
+▲ User config: template variable worktree is deprecated in favor of worktree_path
+▲ User config: template variable main_worktree is deprecated in favor of repo
+▲ User config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
○ Expanding worktree-path
  ../{{ main_worktree }}.{{ branch }}
  →
diff --git a/tests/snapshots/integration__integration_tests__config_show__wt_list_skips_migration_file_after_first_write.snap b/tests/snapshots/integration__integration_tests__config_show__wt_list_skips_migration_file_after_first_write.snap
index 1f0812518..6c243ac4b 100644
--- a/tests/snapshots/integration__integration_tests__config_show__wt_list_skips_migration_file_after_first_write.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__wt_list_skips_migration_file_after_first_write.snap
@@ -50,4 +50,6 @@ exit_code: 0
○ Showing 4 worktrees, 1 with changes, 3 ahead
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: template variable main_worktree is deprecated in favor of repo
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__both_create_and_start.snap b/tests/snapshots/integration__integration_tests__post_start_commands__both_create_and_start.snap
index a57ee1b3a..eef863195 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__both_create_and_start.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__both_create_and_start.snap
@@ -45,7 +45,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start project hook @ _REPO_.feature
  echo 'Setup done' > setup.txt
✓ Created branch feature from main and worktree @ _REPO_.feature
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_base_variables.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_base_variables.snap
index 00e21b0d4..9cc2b12ba 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_base_variables.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_base_variables.snap
@@ -47,7 +47,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start project:base @ _REPO_.feature
  echo 'Base: main' > base_info.txt
◎ Running pre-start project:base_path @ _REPO_.feature
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_default_branch_template.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_default_branch_template.snap
index b7b7c417c..2f04f463f 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_default_branch_template.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_default_branch_template.snap
@@ -46,7 +46,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start project hook @ _REPO_.feature
  echo 'Default: main' > default.txt
✓ Created branch feature from main and worktree @ _REPO_.feature
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_failing_command.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_failing_command.snap
index 577e7e3e9..ce0b56dcd 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_failing_command.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_failing_command.snap
@@ -45,7 +45,8 @@ exit_code: 1
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start project hook @ _REPO_.feature
  exit 1
✗ pre-start command failed: exit status: 1
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_git_variables_template.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_git_variables_template.snap
index 8f6e583c3..178294307 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_git_variables_template.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_git_variables_template.snap
@@ -46,7 +46,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start project:commit @ _REPO_.feature
  echo 'Commit: f9680d376e0968fcb45a0029cf83898054742923' > git_vars.txt
◎ Running pre-start project:short @ _REPO_.feature
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_multiline_control_structure.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_multiline_control_structure.snap
index e4578d5c1..74ec41758 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_multiline_control_structure.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_multiline_control_structure.snap
@@ -45,7 +45,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start project hook @ _REPO_.feature
  if [ ! -f test.txt ]; then
   echo 'File does not exist' > result.txt
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_named_commands.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_named_commands.snap
index 8f6f62938..db50d88bb 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_named_commands.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_named_commands.snap
@@ -45,7 +45,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start project:install @ _REPO_.feature
  echo 'Installing deps'
Installing deps
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_single_command.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_single_command.snap
index a815593de..22b76b7e8 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_single_command.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_single_command.snap
@@ -45,7 +45,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start project hook @ _REPO_.feature
  echo 'Setup complete'
Setup complete
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_template_expansion.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_template_expansion.snap
index 45a1c4b08..9a7341937 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_template_expansion.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_template_expansion.snap
@@ -45,7 +45,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start project:repo @ _REPO_.feature-test
  echo 'Repo: repo' > info.txt
◎ Running pre-start project:branch @ _REPO_.feature-test
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_upstream_conditional.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_upstream_conditional.snap
index 6bbbcafbc..70c6b27f7 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_upstream_conditional.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_upstream_conditional.snap
@@ -46,7 +46,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start project hook @ _REPO_.feature
  echo 'no-upstream' > upstream.txt
✓ Created branch feature from main and worktree @ _REPO_.feature
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_upstream_template.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_upstream_template.snap
index e17d20473..a5a70a064 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_upstream_template.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_upstream_template.snap
@@ -46,7 +46,8 @@ exit_code: 1
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
✗ Failed to expand project pre-start hook: undefined value @ line 1
  echo 'Upstream: {{ upstream }}' > upstream.txt
↳ Available variables: base, base_worktree_path, branch, commit, cwd, default_branch, hook_type, main_worktree, main_worktree_path, primary_worktree_path, remote, remote_url, repo, repo_path, repo_root, short_commit, worktree, worktree_name, worktree_path
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_verbose_template_expansion.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_verbose_template_expansion.snap
index 07dca6409..5f496d241 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_verbose_template_expansion.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_verbose_template_expansion.snap
@@ -46,7 +46,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ Project config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
○ Expanding worktree-path
  ../{{ repo }}.{{ branch | sanitize }}
  →
diff --git a/tests/snapshots/integration__integration_tests__user_hooks__no_hooks_skips_all_hooks.snap b/tests/snapshots/integration__integration_tests__user_hooks__no_hooks_skips_all_hooks.snap
index 3af720fef..98e9d837e 100644
--- a/tests/snapshots/integration__integration_tests__user_hooks__no_hooks_skips_all_hooks.snap
+++ b/tests/snapshots/integration__integration_tests__user_hooks__no_hooks_skips_all_hooks.snap
@@ -46,7 +46,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ User config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ User config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
✓ Created branch feature from main and worktree @ _REPO_.feature
↳ To customize worktree locations, run wt config create
▲ Cannot change directory — shell integration not installed
diff --git a/tests/snapshots/integration__integration_tests__user_hooks__user_hook_template_vars.snap b/tests/snapshots/integration__integration_tests__user_hooks__user_hook_template_vars.snap
index e5ead89af..b58d13b55 100644
--- a/tests/snapshots/integration__integration_tests__user_hooks__user_hook_template_vars.snap
+++ b/tests/snapshots/integration__integration_tests__user_hooks__user_hook_template_vars.snap
@@ -45,7 +45,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ User config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ User config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start user:vars @ _REPO_.feature
  echo 'repo=repo branch=feature' > template_vars.txt
✓ Created branch feature from main and worktree @ _REPO_.feature
diff --git a/tests/snapshots/integration__integration_tests__user_hooks__user_hooks_before_project.snap b/tests/snapshots/integration__integration_tests__user_hooks__user_hooks_before_project.snap
index 6b989790f..632e3a38f 100644
--- a/tests/snapshots/integration__integration_tests__user_hooks__user_hooks_before_project.snap
+++ b/tests/snapshots/integration__integration_tests__user_hooks__user_hooks_before_project.snap
@@ -45,8 +45,9 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ User config has deprecated settings. Run wt config show for details or wt config update to apply updates
-▲ Project config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ User config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
+▲ Project config: post-create hook is deprecated in favor of pre-start
◎ Running pre-start user:log @ _REPO_.feature
  echo 'USER_HOOK' >> hook_order.txt
◎ Running pre-start project hook @ _REPO_.feature
diff --git a/tests/snapshots/integration__integration_tests__user_hooks__user_hooks_no_approval.snap b/tests/snapshots/integration__integration_tests__user_hooks__user_hooks_no_approval.snap
index 76d0d352b..70f6099c5 100644
--- a/tests/snapshots/integration__integration_tests__user_hooks__user_hooks_no_approval.snap
+++ b/tests/snapshots/integration__integration_tests__user_hooks__user_hooks_no_approval.snap
@@ -45,7 +45,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ User config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ User config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start user:setup @ _REPO_.feature
  echo 'NO_APPROVAL_NEEDED' > no_approval.txt
✓ Created branch feature from main and worktree @ _REPO_.feature
diff --git a/tests/snapshots/integration__integration_tests__user_hooks__user_hooks_preserve_order.snap b/tests/snapshots/integration__integration_tests__user_hooks__user_hooks_preserve_order.snap
index 89832480c..f042c83ef 100644
--- a/tests/snapshots/integration__integration_tests__user_hooks__user_hooks_preserve_order.snap
+++ b/tests/snapshots/integration__integration_tests__user_hooks__user_hooks_preserve_order.snap
@@ -45,7 +45,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ User config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ User config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start user:vscode @ _REPO_.feature
  echo '1' >> hook_order.txt
◎ Running pre-start user:claude @ _REPO_.feature
diff --git a/tests/snapshots/integration__integration_tests__user_hooks__user_post_create_executes.snap b/tests/snapshots/integration__integration_tests__user_hooks__user_post_create_executes.snap
index 75c5c27a8..f6714f40d 100644
--- a/tests/snapshots/integration__integration_tests__user_hooks__user_post_create_executes.snap
+++ b/tests/snapshots/integration__integration_tests__user_hooks__user_post_create_executes.snap
@@ -45,7 +45,8 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ User config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ User config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start user:log @ _REPO_.feature
  echo 'USER_POST_CREATE_RAN' > user_hook_marker.txt
✓ Created branch feature from main and worktree @ _REPO_.feature
diff --git a/tests/snapshots/integration__integration_tests__user_hooks__user_post_create_failure.snap b/tests/snapshots/integration__integration_tests__user_hooks__user_post_create_failure.snap
index 426849182..12568f28f 100644
--- a/tests/snapshots/integration__integration_tests__user_hooks__user_post_create_failure.snap
+++ b/tests/snapshots/integration__integration_tests__user_hooks__user_post_create_failure.snap
@@ -45,7 +45,8 @@ exit_code: 1
----- stdout -----
----- stderr -----
-▲ User config has deprecated settings. Run wt config show for details or wt config update to apply updates
+▲ User config: post-create hook is deprecated in favor of pre-start
+↳ To see details, run wt config show; to apply updates, run wt config update
◎ Running pre-start user:failing @ _REPO_.feature
  exit 1
✗ pre-start command failed: failing: exit status: 1