Skip to content

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

feat: show shell integration warnings for all switch operations (#377)

Maximilian Roos058bfab19582
diff --git a/.claude/rules/cli-output-formatting.md b/.claude/rules/cli-output-formatting.md
index ef3a788d3..6d2545b02 100644
--- a/.claude/rules/cli-output-formatting.md
+++ b/.claude/rules/cli-output-formatting.md
@@ -136,7 +136,7 @@ limitation and its reason:
```rust
// Outcome, but limitation — reason
"Worktree for feature @ ~/repo.feature, but cannot change directory — shell integration not installed"
-"Worktree for feature @ ~/repo.feature, but cannot change directory — shell integration not active"
+"Worktree for feature @ ~/repo.feature, but cannot change directory — shell requires restart"
```
This pattern:
diff --git a/src/output/handlers.rs b/src/output/handlers.rs
index fcfb1134a..ad67c7543 100644
--- a/src/output/handlers.rs
+++ b/src/output/handlers.rs
@@ -592,13 +592,26 @@ fn print_switch_message_if_changed(
/// Handle output for a switch operation
///
-/// For existing worktrees: when shell integration is not active, we show
-/// warnings that the shell's directory won't change. This includes when
-/// `--execute` is used — the command runs in the target directory, but the
-/// shell stays put.
+/// # Shell Integration Warnings
///
-/// For created worktrees: success message only (creation success trumps the
-/// shell warning, and post-create hooks provide value even without cd).
+/// Always warn when the shell's directory won't change. Users expect to be in
+/// the target worktree after switching.
+///
+/// **When to warn:** Shell integration is not active (`WORKTRUNK_DIRECTIVE_FILE`
+/// not set). This applies to both `Existing` and `Created` results.
+///
+/// **When NOT to warn:**
+/// - `AlreadyAt` — user is already in the target directory
+/// - Shell integration IS active — cd will happen automatically
+///
+/// **Warning reasons:**
+/// - "shell requires restart" — shell config has `eval` line but wrapper not active
+/// - "shell integration not installed" — shell config doesn't have `eval` line
+///
+/// **Message order for Created:** Success message first, then warning. Creation
+/// is a real accomplishment, but users still need to know they won't cd there.
+///
+/// # Return Value
///
/// Returns `Some(path)` when post-switch hooks should show "@ path" in their
/// announcements (because the user's shell won't be in that directory). This happens when:
@@ -621,6 +634,19 @@ pub fn handle_switch_output(
// Check if shell integration is active (directive file set)
let is_shell_integration_active = super::is_shell_integration_active();
+ // Compute shell warning reason once (only if we'll need it)
+ let shell_warning_reason = if is_shell_integration_active {
+ None
+ } else if Shell::is_integration_configured(&crate::binary_name())
+ .ok()
+ .flatten()
+ .is_some()
+ {
+ Some("shell requires restart")
+ } else {
+ Some("shell integration not installed")
+ };
+
// Show path mismatch warning after the main message
let path_mismatch_warning = branch_info.expected_path.as_ref().map(|expected| {
let expected_display = format_path_for_display(expected);
@@ -629,13 +655,9 @@ pub fn handle_switch_output(
))
});
- // Track whether user's shell will be in the worktree directory.
- // If not, hooks should show "@ path" to clarify where they run.
- // Note: --execute runs commands in the worktree but doesn't move the user's shell there
- let user_will_be_there = is_shell_integration_active;
-
let display_path_for_hooks = match result {
SwitchResult::AlreadyAt(_) => {
+ // Already in target directory — no shell warning needed
super::print(info_message(cformat!(
"Already on worktree for <bold>{branch}</> @ <bold>{path_display}</>"
)))?;
@@ -646,28 +668,8 @@ pub fn handle_switch_output(
None
}
SwitchResult::Existing(_) => {
- if user_will_be_there {
- // Shell integration active — cd will happen automatically
- super::print(info_message(format_switch_message(
- branch, path, false, None, None,
- )))?;
- if let Some(warning) = path_mismatch_warning {
- super::print(warning)?;
- }
- // cd will happen - no path annotation needed
- None
- } else {
+ if let Some(reason) = shell_warning_reason {
// Shell integration not active — warn that shell won't cd
- let reason = if Shell::is_integration_configured(&crate::binary_name())
- .ok()
- .flatten()
- .is_some()
- {
- "restart the shell to activate"
- } else {
- "shell integration not installed"
- };
-
if let Some(cmd) = execute_command {
// --execute: command will run in target dir, but shell stays put
super::print(warning_message(cformat!(
@@ -684,6 +686,16 @@ pub fn handle_switch_output(
}
// User won't be there - show path in hook announcements
Some(path.clone())
+ } else {
+ // Shell integration active — cd will happen automatically
+ super::print(info_message(format_switch_message(
+ branch, path, false, None, None,
+ )))?;
+ if let Some(warning) = path_mismatch_warning {
+ super::print(warning)?;
+ }
+ // cd will happen - no path annotation needed
+ None
}
}
SwitchResult::Created {
@@ -692,6 +704,7 @@ pub fn handle_switch_output(
from_remote,
..
} => {
+ // Always show success for creation
super::print(success_message(format_switch_message(
branch,
path,
@@ -699,12 +712,27 @@ pub fn handle_switch_output(
base_branch.as_deref(),
from_remote.as_deref(),
)))?;
- // If shell integration not active, show path in hook announcements
- if user_will_be_there {
- None
- } else {
+
+ // Warn if shell won't cd to the new worktree
+ if let Some(reason) = shell_warning_reason {
+ if let Some(cmd) = execute_command {
+ super::print(warning_message(cformat!(
+ "Executing <bold>{cmd}</> @ <bold>{path_display}</>, but shell directory unchanged — {reason}"
+ )))?;
+ } else {
+ // Don't repeat "Created worktree" — success message above already said that
+ super::print(warning_message(cformat!(
+ "Cannot change directory — {reason}"
+ )))?;
+ }
+ // User won't be there - show path in hook announcements
Some(path.clone())
+ } else {
+ // cd will happen - no path annotation needed
+ None
}
+ // Note: No path_mismatch_warning — created worktrees are always at
+ // the expected path (SwitchBranchInfo::expected_path is None)
}
};
diff --git a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_accept.snap b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_accept.snap
index abd592274..58859b2cc 100644
--- a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_accept.snap
+++ b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_accept.snap
@@ -13,4 +13,5 @@ y
  echo 'test command'
test command
✓ Created new worktree for test-approve from main @ _REPO_/repo.BRANCH
+▲ Cannot change directory — shell requires restart
↳ Restart shell to activate shell integration
diff --git a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_decline.snap b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_decline.snap
index d39ac1ddc..0bf72e267 100644
--- a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_decline.snap
+++ b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_decline.snap
@@ -11,4 +11,5 @@ n
❯ Allow and remember? [y/N]
○ Commands declined, continuing worktree creation
✓ Created new worktree for test-decline from main @ _REPO_/repo.BRANCH
+▲ Cannot change directory — shell requires restart
↳ Restart shell to activate shell integration
diff --git a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_mixed_approved_unapproved_accept.snap b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_mixed_approved_unapproved_accept.snap
index 334409fd5..4ed142980 100644
--- a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_mixed_approved_unapproved_accept.snap
+++ b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_mixed_approved_unapproved_accept.snap
@@ -21,4 +21,5 @@ y
  echo 'Third command'
Third command
✓ Created new worktree for test-mixed-accept from main @ _REPO_/repo.BRANCH
+▲ Cannot change directory — shell requires restart
↳ Restart shell to activate shell integration
diff --git a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_mixed_approved_unapproved_decline.snap b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_mixed_approved_unapproved_decline.snap
index c2fa6de32..d381bc478 100644
--- a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_mixed_approved_unapproved_decline.snap
+++ b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_mixed_approved_unapproved_decline.snap
@@ -13,4 +13,5 @@ n
❯ Allow and remember? [y/N]
○ Commands declined, continuing worktree creation
✓ Created new worktree for test-mixed-decline from main @ _REPO_/repo.BRANCH
+▲ Cannot change directory — shell requires restart
↳ Restart shell to activate shell integration
diff --git a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_multiple_commands.snap b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_multiple_commands.snap
index c43d70441..8a782fc98 100644
--- a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_multiple_commands.snap
+++ b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_multiple_commands.snap
@@ -23,4 +23,5 @@ y
  echo 'Third command'
Third command
✓ Created new worktree for test-multi from main @ _REPO_/repo.BRANCH
+▲ Cannot change directory — shell requires restart
↳ Restart shell to activate shell integration
diff --git a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_named_commands.snap b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_named_commands.snap
index b6ab66f1d..5d73162cd 100644
--- a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_named_commands.snap
+++ b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_named_commands.snap
@@ -23,4 +23,5 @@ y
  echo 'Running tests...'
Running tests...
✓ Created new worktree for test-named from main @ _REPO_/repo.BRANCH
+▲ Cannot change directory — shell requires restart
↳ Restart shell to activate shell integration
diff --git a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_permission_error.snap b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_permission_error.snap
index 7e20bff98..3f5085c18 100644
--- a/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_permission_error.snap
+++ b/tests/integration_tests/snapshots/integration__integration_tests__approval_pty__approval_prompt_permission_error.snap
@@ -15,4 +15,5 @@ y
  echo 'test command'
test command
✓ Created new worktree for test-permission from main @ _REPO_/repo.BRANCH
+▲ Cannot change directory — shell requires restart
↳ Restart shell to activate shell integration
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 8816c8675..79424d929 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
@@ -35,4 +35,5 @@ exit_code: 0
◎ Running post-create project hook:
  echo 'approved' > output.txt
✓ Created new worktree for test-approved from main @ _REPO_.test-approved
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 053dc7793..a8733839e 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
@@ -37,4 +37,5 @@ exit_code: 0
  echo 'test command'
test command
✓ Created new worktree for test-yes-tty from main @ _REPO_.test-yes-tty
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 d16383283..ea2243182 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
@@ -36,4 +36,5 @@ exit_code: 0
◎ Running post-create project hook:
  echo 'test command' > output.txt
✓ Created new worktree for test-yes from main @ _REPO_.test-yes
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__merge__readme_example_hooks_post_create.snap b/tests/snapshots/integration__integration_tests__merge__readme_example_hooks_post_create.snap
index 74e4479e8..d5ae62430 100644
--- a/tests/snapshots/integration__integration_tests__merge__readme_example_hooks_post_create.snap
+++ b/tests/snapshots/integration__integration_tests__merge__readme_example_hooks_post_create.snap
@@ -39,6 +39,7 @@ exit_code: 0
Resolved 24 packages in 145ms
Installed 24 packages in 1.2s
✓ Created new worktree for feature-x from main @ _REPO_.feature-x
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-start project:dev:
  uv run dev
diff --git a/tests/snapshots/integration__integration_tests__merge__readme_example_simple_switch.snap b/tests/snapshots/integration__integration_tests__merge__readme_example_simple_switch.snap
index 121ad62c9..ace8ad51e 100644
--- a/tests/snapshots/integration__integration_tests__merge__readme_example_simple_switch.snap
+++ b/tests/snapshots/integration__integration_tests__merge__readme_example_simple_switch.snap
@@ -33,4 +33,5 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for fix-auth from main @ _REPO_.fix-auth
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 3084e5362..c3a89cdc9 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
@@ -35,6 +35,7 @@ exit_code: 0
◎ Running post-create project hook:
  echo 'Setup done' > setup.txt
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-start project:server:
  sleep 0.05 && echo 'Server running' > server.txt
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__execute_with_post_start.snap b/tests/snapshots/integration__integration_tests__post_start_commands__execute_with_post_start.snap
index 036d01a63..1be1a9572 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__execute_with_post_start.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__execute_with_post_start.snap
@@ -35,6 +35,7 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Executing echo 'Execute flag' > execute.txt @ _REPO_.feature, but shell directory unchanged — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-start project hook:
  echo 'Background task' > background.txt
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 9c7b5dee8..24000f26c 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
@@ -36,4 +36,5 @@ exit_code: 0
◎ Running post-create project hook:
  echo 'Default: main' > default.txt
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 da201813f..7801e4524 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
@@ -36,4 +36,5 @@ exit_code: 0
  exit 1
▲ Command failed: exit status: 1
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 f9bb8cc93..31a81bf3d 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
@@ -42,4 +42,5 @@ exit_code: 0
◎ Running post-create project:worktree_name:
  echo 'Worktree Name: repo.feature' >> git_vars.txt
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 a8ededd2c..70df6aaeb 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
@@ -39,4 +39,5 @@ exit_code: 0
   echo 'File exists' > result.txt
  fi
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 4893dcaab..79b6be1e8 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
@@ -39,4 +39,5 @@ exit_code: 0
  echo 'Running setup'
Running setup
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_no_config.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_no_config.snap
index 9ac8f5956..4265b9038 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_create_no_config.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_create_no_config.snap
@@ -33,4 +33,5 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 f9fa2602e..f403dad68 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
@@ -36,4 +36,5 @@ exit_code: 0
  echo 'Setup complete'
Setup complete
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 b2e785d02..e69b2d9c8 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
@@ -43,4 +43,5 @@ exit_code: 0
◎ Running post-create project:root:
  echo 'Root: _REPO_' >> info.txt
✓ Created new worktree for feature/test from main @ _REPO_.feature-test
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 4a2c740ae..e9945d948 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
@@ -36,4 +36,5 @@ exit_code: 0
◎ Running post-create project hook:
  echo 'Upstream: ' > upstream.txt
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_complex_shell.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_complex_shell.snap
index 12fd7d8fe..caf05bd94 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_complex_shell.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_complex_shell.snap
@@ -33,6 +33,7 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-start project hook:
  echo 'line1
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_create_with_command.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_create_with_command.snap
index 97c786649..45592413b 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_create_with_command.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_create_with_command.snap
@@ -33,6 +33,7 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-start project hook:
  echo 'POST-START-RAN' > post_start_marker.txt
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_invalid_command.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_invalid_command.snap
index 082e20ca1..d55c600c8 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_invalid_command.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_invalid_command.snap
@@ -33,6 +33,7 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-start project hook:
  echo 'unclosed quote
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_log_captures_output.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_log_captures_output.snap
index 831831884..2814f01d4 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_log_captures_output.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_log_captures_output.snap
@@ -33,6 +33,7 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-start project hook:
  echo 'stdout output' && echo 'stderr output' >&2
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_multiline_with_newlines.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_multiline_with_newlines.snap
index 68ba09a92..436f1b6bb 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_multiline_with_newlines.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_multiline_with_newlines.snap
@@ -33,6 +33,7 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-start project hook:
  echo 'first line' > multiline.txt
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_multiple_background.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_multiple_background.snap
index 2c883bffd..f6b99e916 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_multiple_background.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_multiple_background.snap
@@ -33,6 +33,7 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-start project:task1:
  echo 'Task 1 running' > task1.txt
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_separate_logs.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_separate_logs.snap
index 0a784835e..7b1388b31 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_separate_logs.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_separate_logs.snap
@@ -33,6 +33,7 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-start project:task1:
  echo 'TASK1_OUTPUT'
diff --git a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_single_background.snap b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_single_background.snap
index 11d0ca52a..21d9fb81c 100644
--- a/tests/snapshots/integration__integration_tests__post_start_commands__post_start_single_background.snap
+++ b/tests/snapshots/integration__integration_tests__post_start_commands__post_start_single_background.snap
@@ -33,6 +33,7 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-start project hook:
  sleep 0.1 && echo 'Background task done' > background.txt
diff --git a/tests/snapshots/integration__integration_tests__shell_integration_prompt__pty_tests__prompt_accept.snap b/tests/snapshots/integration__integration_tests__shell_integration_prompt__pty_tests__prompt_accept.snap
index 317bba710..ec68ce6ea 100644
--- a/tests/snapshots/integration__integration_tests__shell_integration_prompt__pty_tests__prompt_accept.snap
+++ b/tests/snapshots/integration__integration_tests__shell_integration_prompt__pty_tests__prompt_accept.snap
@@ -5,6 +5,7 @@ expression: normalized
y
✓ Created new worktree for feature from main @ [REPO]/repo.feature
+▲ Cannot change directory — shell integration not installed
❯ Install shell integration? [y/N/?]
✓ Added shell extension & completions for bash @ ~/.bashrc
diff --git a/tests/snapshots/integration__integration_tests__shell_integration_prompt__pty_tests__prompt_decline.snap b/tests/snapshots/integration__integration_tests__shell_integration_prompt__pty_tests__prompt_decline.snap
index b93396431..9dd0d0ec9 100644
--- a/tests/snapshots/integration__integration_tests__shell_integration_prompt__pty_tests__prompt_decline.snap
+++ b/tests/snapshots/integration__integration_tests__shell_integration_prompt__pty_tests__prompt_decline.snap
@@ -5,6 +5,7 @@ expression: normalized
n
✓ Created new worktree for feature from main @ [REPO]/repo.feature
+▲ Cannot change directory — shell integration not installed
❯ Install shell integration? [y/N/?]
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__shell_integration_prompt__pty_tests__prompt_preview_decline.snap b/tests/snapshots/integration__integration_tests__shell_integration_prompt__pty_tests__prompt_preview_decline.snap
index 2a1d0dc02..2bfcd805e 100644
--- a/tests/snapshots/integration__integration_tests__shell_integration_prompt__pty_tests__prompt_preview_decline.snap
+++ b/tests/snapshots/integration__integration_tests__shell_integration_prompt__pty_tests__prompt_preview_decline.snap
@@ -6,6 +6,7 @@ expression: normalized
n
✓ Created new worktree for feature from main @ [REPO]/repo.feature
+▲ Cannot change directory — shell integration not installed
❯ Install shell integration? [y/N/?]
○ Will add shell extension & completions for bash @ ~/.bashrc
diff --git a/tests/snapshots/integration__integration_tests__switch__create_with_base_main.snap b/tests/snapshots/integration__integration_tests__switch__create_with_base_main.snap
index 1d23e3b57..01cc632c9 100644
--- a/tests/snapshots/integration__integration_tests__switch__create_with_base_main.snap
+++ b/tests/snapshots/integration__integration_tests__switch__create_with_base_main.snap
@@ -35,4 +35,5 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for new-feature from main @ _REPO_.new-feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__ping_pong_1_main_to_feature_a.snap b/tests/snapshots/integration__integration_tests__switch__ping_pong_1_main_to_feature_a.snap
index 04d1268c5..545b54188 100644
--- a/tests/snapshots/integration__integration_tests__switch__ping_pong_1_main_to_feature_a.snap
+++ b/tests/snapshots/integration__integration_tests__switch__ping_pong_1_main_to_feature_a.snap
@@ -32,4 +32,5 @@ exit_code: 0
----- stderr -----
✓ Switched to worktree for feature-a @ _REPO_.feature-a
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_clobber_path_with_extension.snap b/tests/snapshots/integration__integration_tests__switch__switch_clobber_path_with_extension.snap
index dd3e01e2e..fe2749365 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_clobber_path_with_extension.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_clobber_path_with_extension.snap
@@ -35,4 +35,5 @@ exit_code: 0
----- stderr -----
▲ Moving _REPO_.clobber-ext.txt to _REPO_.clobber-ext.txt.bak.20250102-000000 (--clobber)
✓ Created new worktree for clobber-ext.txt from main @ _REPO_.clobber-ext.txt
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_clobber_removes_stale_dir.snap b/tests/snapshots/integration__integration_tests__switch__switch_clobber_removes_stale_dir.snap
index e57a2c9e3..4b433d300 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_clobber_removes_stale_dir.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_clobber_removes_stale_dir.snap
@@ -35,4 +35,5 @@ exit_code: 0
----- stderr -----
▲ Moving _REPO_.clobber-dir-test to _REPO_.clobber-dir-test.bak.20250102-000000 (--clobber)
✓ Created new worktree for clobber-dir-test from main @ _REPO_.clobber-dir-test
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_clobber_removes_stale_file.snap b/tests/snapshots/integration__integration_tests__switch__switch_clobber_removes_stale_file.snap
index 039e5ced0..0aad72f34 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_clobber_removes_stale_file.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_clobber_removes_stale_file.snap
@@ -35,4 +35,5 @@ exit_code: 0
----- stderr -----
▲ Moving _REPO_.clobber-file-test to _REPO_.clobber-file-test.bak.20250102-000000 (--clobber)
✓ Created new worktree for clobber-file-test from main @ _REPO_.clobber-file-test
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_create_new.snap b/tests/snapshots/integration__integration_tests__switch__switch_create_new.snap
index 94da013e6..d6c2b0ca2 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_create_new.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_create_new.snap
@@ -33,4 +33,5 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature-x from main @ _REPO_.feature-x
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_create_no_remote.snap b/tests/snapshots/integration__integration_tests__switch__switch_create_no_remote.snap
index 443fa44e3..3fa54fcde 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_create_no_remote.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_create_no_remote.snap
@@ -33,4 +33,5 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_create_remote_only.snap b/tests/snapshots/integration__integration_tests__switch__switch_create_remote_only.snap
index 110b0077f..74dd77eab 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_create_remote_only.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_create_remote_only.snap
@@ -35,4 +35,5 @@ exit_code: 0
▲ Branch remote-feature exists on remote (origin/remote-feature); creating new branch from base instead
↳ To switch to the remote branch, remove --create; run wt switch remote-feature
✓ Created new worktree for remote-feature from main @ _REPO_.remote-feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_execute_creates_file.snap b/tests/snapshots/integration__integration_tests__switch__switch_execute_creates_file.snap
index e4079ab15..bb9b5c4e9 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_execute_creates_file.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_execute_creates_file.snap
@@ -35,6 +35,7 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for file-test from main @ _REPO_.file-test
+▲ Executing echo 'test content' > test.txt @ _REPO_.file-test, but shell directory unchanged — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Executing (--execute):
  echo 'test content' > test.txt
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_execute_failure.snap b/tests/snapshots/integration__integration_tests__switch__switch_execute_failure.snap
index 89cec192d..72423262f 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_execute_failure.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_execute_failure.snap
@@ -35,6 +35,7 @@ exit_code: 1
----- stderr -----
✓ Created new worktree for fail-test from main @ _REPO_.fail-test
+▲ Executing exit 1 @ _REPO_.fail-test, but shell directory unchanged — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Executing (--execute):
  exit 1
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_execute_multiline.snap b/tests/snapshots/integration__integration_tests__switch__switch_execute_multiline.snap
index 582c0053f..b00dda150 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_execute_multiline.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_execute_multiline.snap
@@ -38,6 +38,9 @@ line3
----- stderr -----
✓ Created new worktree for multiline-test from main @ _REPO_.multiline-test
+▲ Executing echo 'line1'
+echo 'line2'
+echo 'line3' @ _REPO_.multiline-test, but shell directory unchanged — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Executing (--execute):
  echo 'line1'
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_execute_success.snap b/tests/snapshots/integration__integration_tests__switch__switch_execute_success.snap
index 0bdd90a47..836b6afbf 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_execute_success.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_execute_success.snap
@@ -36,6 +36,7 @@ test output
----- stderr -----
✓ Created new worktree for exec-test from main @ _REPO_.exec-test
+▲ Executing echo 'test output' @ _REPO_.exec-test, but shell directory unchanged — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Executing (--execute):
  echo 'test output'
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_existing_with_shell_configured.snap b/tests/snapshots/integration__integration_tests__switch__switch_existing_with_shell_configured.snap
index 5542c4143..6b562fda2 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_existing_with_shell_configured.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_existing_with_shell_configured.snap
@@ -20,9 +20,11 @@ info:
LC_ALL: C
PATH: "[PATH]"
RUST_LOG: warn
+ SHELL: /bin/zsh
SOURCE_DATE_EPOCH: "1735776000"
USERPROFILE: "[TEST_HOME]"
WORKTRUNK_CONFIG_PATH: "[TEST_CONFIG]"
+ WORKTRUNK_TEST_SKIP_URL_HEALTH_CHECK: "1"
XDG_CONFIG_HOME: "[TEST_CONFIG_HOME]"
---
success: true
@@ -30,5 +32,5 @@ exit_code: 0
----- stdout -----
----- stderr -----
-▲ Worktree for shell-configured @ _REPO_.shell-configured, but cannot change directory — restart the shell to activate
+▲ Worktree for shell-configured @ _REPO_.shell-configured, but cannot change directory — shell requires restart
↳ Restart shell to activate shell integration
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_main_branch_to_feature.snap b/tests/snapshots/integration__integration_tests__switch__switch_main_branch_to_feature.snap
index 04d1268c5..545b54188 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_main_branch_to_feature.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_main_branch_to_feature.snap
@@ -32,4 +32,5 @@ exit_code: 0
----- stderr -----
✓ Switched to worktree for feature-a @ _REPO_.feature-a
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_no_hooks_execute_still_runs.snap b/tests/snapshots/integration__integration_tests__switch__switch_no_hooks_execute_still_runs.snap
index 169f33647..7a988bf00 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_no_hooks_execute_still_runs.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_no_hooks_execute_still_runs.snap
@@ -37,6 +37,7 @@ execute command runs
----- stderr -----
✓ Created new worktree for no-hooks-test from main @ _REPO_.no-hooks-test
+▲ Executing echo 'execute command runs' @ _REPO_.no-hooks-test, but shell directory unchanged — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Executing (--execute):
  echo 'execute command runs'
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_no_hooks_skips_post_start.snap b/tests/snapshots/integration__integration_tests__switch__switch_no_hooks_skips_post_start.snap
index aed3b4b08..c10f56cc1 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_no_hooks_skips_post_start.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_no_hooks_skips_post_start.snap
@@ -34,4 +34,5 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for no-post-start from main @ _REPO_.no-post-start
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_no_hooks_with_yes.snap b/tests/snapshots/integration__integration_tests__switch__switch_no_hooks_with_yes.snap
index 7521d18f6..46782431c 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_no_hooks_with_yes.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_no_hooks_with_yes.snap
@@ -35,4 +35,5 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for yes-no-hooks from main @ _REPO_.yes-no-hooks
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_post_hook_path_annotation.snap b/tests/snapshots/integration__integration_tests__switch__switch_post_hook_path_annotation.snap
index 5c39d1943..61efffc01 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_post_hook_path_annotation.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_post_hook_path_annotation.snap
@@ -34,6 +34,7 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for post-hook-test from main @ _REPO_.post-hook-test
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-switch project hook @ _REPO_.post-hook-test:
  echo switched
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_primary_on_different_branch.snap b/tests/snapshots/integration__integration_tests__switch__switch_primary_on_different_branch.snap
index 211cdc124..2f096f405 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_primary_on_different_branch.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_primary_on_different_branch.snap
@@ -33,4 +33,5 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature-from-main from main @ _REPO_.feature-from-main
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_stale_history_to_a.snap b/tests/snapshots/integration__integration_tests__switch__switch_stale_history_to_a.snap
index 7ac6b65f3..818bbb255 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_stale_history_to_a.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_stale_history_to_a.snap
@@ -32,4 +32,5 @@ exit_code: 0
----- stderr -----
✓ Switched to worktree for branch-a @ _REPO_.branch-a
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_stale_history_to_b.snap b/tests/snapshots/integration__integration_tests__switch__switch_stale_history_to_b.snap
index ea45a8209..300fcadd1 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_stale_history_to_b.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_stale_history_to_b.snap
@@ -32,4 +32,5 @@ exit_code: 0
----- stderr -----
✓ Switched to worktree for branch-b @ _REPO_.branch-b
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__switch__switch_with_base.snap b/tests/snapshots/integration__integration_tests__switch__switch_with_base.snap
index 4e658170d..e6c275f9c 100644
--- a/tests/snapshots/integration__integration_tests__switch__switch_with_base.snap
+++ b/tests/snapshots/integration__integration_tests__switch__switch_with_base.snap
@@ -35,4 +35,5 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature-with-base from main @ _REPO_.feature-with-base
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__user_hooks__no_verify_skips_all_hooks.snap b/tests/snapshots/integration__integration_tests__user_hooks__no_verify_skips_all_hooks.snap
index 9cc97e2e9..3c469edfd 100644
--- a/tests/snapshots/integration__integration_tests__user_hooks__no_verify_skips_all_hooks.snap
+++ b/tests/snapshots/integration__integration_tests__user_hooks__no_verify_skips_all_hooks.snap
@@ -34,4 +34,5 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__user_hooks__user_and_project_post_start.snap b/tests/snapshots/integration__integration_tests__user_hooks__user_and_project_post_start.snap
index 8c1a59297..a556b50f6 100644
--- a/tests/snapshots/integration__integration_tests__user_hooks__user_and_project_post_start.snap
+++ b/tests/snapshots/integration__integration_tests__user_hooks__user_and_project_post_start.snap
@@ -33,6 +33,7 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-start user:bg:
  echo 'USER_POST_START' > user_bg.txt
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 34fa76bb1..7d661bcbf 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
@@ -35,4 +35,5 @@ exit_code: 0
◎ Running post-create user:vars:
  echo 'repo=repo branch=feature' > template_vars.txt
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 3af22899d..a7b8e3750 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
@@ -37,4 +37,5 @@ exit_code: 0
◎ Running post-create project hook:
  echo 'PROJECT_HOOK' >> hook_order.txt
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 dc24d18be..78940e3b4 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
@@ -35,4 +35,5 @@ exit_code: 0
◎ Running post-create user:setup:
  echo 'NO_APPROVAL_NEEDED' > no_approval.txt
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 14e37a6d5..f3596aa2f 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
@@ -35,4 +35,5 @@ exit_code: 0
◎ Running post-create user:log:
  echo 'USER_POST_CREATE_RAN' > user_hook_marker.txt
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
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 d158a4d39..90bc0bc33 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
@@ -36,4 +36,5 @@ exit_code: 0
  exit 1
▲ Command failing failed: exit status: 1
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
diff --git a/tests/snapshots/integration__integration_tests__user_hooks__user_post_start_executes.snap b/tests/snapshots/integration__integration_tests__user_hooks__user_post_start_executes.snap
index 14acb302c..84055507e 100644
--- a/tests/snapshots/integration__integration_tests__user_hooks__user_post_start_executes.snap
+++ b/tests/snapshots/integration__integration_tests__user_hooks__user_post_start_executes.snap
@@ -33,6 +33,7 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install
◎ Running post-start user:bg:
  echo 'USER_POST_START_RAN' > user_bg_marker.txt
diff --git a/tests/snapshots/integration__integration_tests__user_hooks__user_post_start_skipped_no_verify.snap b/tests/snapshots/integration__integration_tests__user_hooks__user_post_start_skipped_no_verify.snap
index 9cc97e2e9..3c469edfd 100644
--- a/tests/snapshots/integration__integration_tests__user_hooks__user_post_start_skipped_no_verify.snap
+++ b/tests/snapshots/integration__integration_tests__user_hooks__user_post_start_skipped_no_verify.snap
@@ -34,4 +34,5 @@ exit_code: 0
----- stderr -----
✓ Created new worktree for feature from main @ _REPO_.feature
+▲ Cannot change directory — shell integration not installed
↳ To enable automatic cd, run wt config shell install