Skip to content

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

feat: add shell probe diagnostics to wt config show (#440)

Maximilian Roose959fbe7846d
diff --git a/.claude-plugin/skills/worktrunk/reference/shell-integration.md b/.claude-plugin/skills/worktrunk/reference/shell-integration.md
index a4323aed0..47d1a1ccd 100644
--- a/.claude-plugin/skills/worktrunk/reference/shell-integration.md
+++ b/.claude-plugin/skills/worktrunk/reference/shell-integration.md
@@ -84,6 +84,32 @@ a subprocess, bypassing the shell wrapper.
**Fix**: Use `wt` directly instead of `git wt` when you need directory switching.
+### "Alias bypasses shell integration"
+
+**Meaning**: You have an alias like `alias gwt="/usr/bin/wt"` or
+`alias gwt="wt.exe"` that points directly to the binary instead of the shell
+function.
+
+When shell integration is installed, it creates a shell function named `wt` (or
+`git-wt`). If your alias points to the binary path, it bypasses this function
+and shell integration won't work.
+
+**Examples that bypass** (won't auto-cd):
+```bash
+alias gwt="/usr/bin/wt"
+alias gwt="wt.exe"
+alias wt="/path/to/wt"
+```
+
+**Fix**: Change the alias to point to the function name instead of the binary:
+```bash
+alias gwt="wt" # Good - uses the shell function
+alias gwt="git-wt" # Good - uses the shell function
+```
+
+`wt config show` detects these problematic aliases and shows a warning with the
+suggested fix.
+
## How the Shell Wrapper Works
The shell wrapper (installed by `wt config shell install`) defines a shell
diff --git a/.claude/rules/cli-output-formatting.md b/.claude/rules/cli-output-formatting.md
index 0d99b138d..4652fcdc2 100644
--- a/.claude/rules/cli-output-formatting.md
+++ b/.claude/rules/cli-output-formatting.md
@@ -533,6 +533,51 @@ output::print(warning_message(warning))?;
## Error Formatting
+### Error Message Structure
+
+Error and warning messages should communicate four things:
+
+1. **What happened** — The actual state or outcome
+2. **What was expected** — The correct or desired state
+3. **The impact** — Why this matters (optional for obvious cases)
+4. **How to resolve** — What the user should do (can be a separate hint message)
+
+```rust
+// GOOD - states actual, expected, and impact in main message
+"Shell probe: wt is binary at /path, not function — won't auto-cd"
+// ^^^^^^^^^^^^^^^ ^^^^^^^^^^^^ ^^^^^^^^^^^^^^
+// actual expected impact
+// Resolution in separate hint: "Restart shell to activate"
+
+// GOOD - actual vs expected with resolution inline
+"Config file has 3 errors, expected valid TOML; run wt config validate for details"
+// ^^^^^^^ ^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+// actual expected resolution
+
+// BAD - only states actual, no expected or impact
+"Shell probe: wt resolves to binary at /path"
+// Missing: what should it be instead? why does it matter?
+
+// BAD - vague, no actionable information
+"Shell integration problem detected"
+// Missing: what's wrong? what should it be? what to do?
+```
+
+When the expected state is obvious from context, it can be implied:
+
+```rust
+// OK - expected state (file should exist) is obvious
+"Config file not found at ~/.config/wt/config.toml"
+
+// OK - expected state (should succeed) is obvious
+"Failed to read config: permission denied"
+```
+
+**Diagnostic messages** (like `wt config show`) should follow this pattern
+especially carefully — users read diagnostics to understand what's wrong.
+
+### Single vs Multi-line
+
**Single-line errors** with variables are fine:
```rust
diff --git a/src/commands/config.rs b/src/commands/config.rs
index 2db382c5f..076fc7508 100644
--- a/src/commands/config.rs
+++ b/src/commands/config.rs
@@ -190,51 +190,22 @@ fn is_plugin_installed() -> bool {
content.contains("\"worktrunk@worktrunk\"")
}
-/// Render runtime information (version, binary name, shell integration status)
+/// Render OTHER section (version, Claude plugin, hyperlinks)
fn render_runtime_info(out: &mut String) -> anyhow::Result<()> {
let cmd = crate::binary_name();
let version = version_str();
- let shell_active = output::is_shell_integration_active();
- // Version as suffix to heading (avoid lonely gutter)
+ // Version as suffix to heading
writeln!(
out,
"{}",
- format_heading("RUNTIME", Some(&cformat!("{cmd} {version}")))
+ format_heading("OTHER", Some(&cformat!("{cmd} {version}")))
)?;
- // Shell integration status
- if shell_active {
- writeln!(out, "{}", info_message("Shell integration active"))?;
- } else {
- writeln!(out, "{}", warning_message("Shell integration not active"))?;
- }
-
- // Cache plugin status for use after debug info
+ // Claude Code plugin status
let plugin_installed = is_plugin_installed();
let claude_available = is_claude_available();
- // Debug info for shell integration troubleshooting
- // Show invocation details that help diagnose issues like https://github.com/max-sixty/worktrunk/pull/387
- let invocation = crate::invocation_path();
- let is_git_subcommand = crate::is_git_subcommand();
-
- // Build debug lines
- let mut debug_lines = Vec::new();
-
- // Always show how wt was invoked
- debug_lines.push(cformat!("Invoked as: <bold>{invocation}</>"));
-
- // Show if running as git subcommand (affects shell integration)
- if is_git_subcommand {
- debug_lines.push("Git subcommand: yes (GIT_EXEC_PATH set)".to_string());
- }
-
- // Show shell integration debug info in a gutter
- let debug_text = debug_lines.join("\n");
- writeln!(out, "{}", format_with_gutter(&debug_text, None))?;
-
- // Claude Code plugin status (after debug info)
if plugin_installed {
writeln!(out, "{}", success_message("Claude Code plugin installed"))?;
} else if claude_available {
@@ -255,7 +226,7 @@ fn render_runtime_info(out: &mut String) -> anyhow::Result<()> {
)?;
}
- // Show hyperlink support status (separate from shell integration)
+ // Show hyperlink support status
let hyperlinks_supported =
worktrunk::styling::supports_hyperlinks(worktrunk::styling::Stream::Stderr);
let status = if hyperlinks_supported {
@@ -463,6 +434,23 @@ fn render_project_config(out: &mut String) -> anyhow::Result<()> {
fn render_shell_status(out: &mut String) -> anyhow::Result<()> {
writeln!(out, "{}", format_heading("SHELL INTEGRATION", None))?;
+ // Shell integration runtime status (moved from RUNTIME section)
+ let shell_active = output::is_shell_integration_active();
+ if shell_active {
+ writeln!(out, "{}", info_message("Shell integration active"))?;
+ } else {
+ writeln!(out, "{}", warning_message("Shell integration not active"))?;
+ // Show invocation details to help diagnose
+ let invocation = crate::invocation_path();
+ let is_git_subcommand = crate::is_git_subcommand();
+ let mut debug_lines = vec![cformat!("Binary invoked as: <bold>{invocation}</>")];
+ if is_git_subcommand {
+ debug_lines.push("Git subcommand: yes (GIT_EXEC_PATH set)".to_string());
+ }
+ writeln!(out, "{}", format_with_gutter(&debug_lines.join("\n"), None))?;
+ }
+ writeln!(out)?;
+
// Use the same detection logic as `wt config shell install`
let cmd = crate::binary_name();
let scan_result = match scan_shell_configs(None, true, &cmd) {
@@ -527,6 +515,18 @@ fn render_shell_status(out: &mut String) -> anyhow::Result<()> {
for detected in &det.matched_lines {
writeln!(out, "{}", format_bash_with_gutter(detected.content.trim()))?;
}
+
+ // Check if any matched lines use .exe suffix and warn about function name
+ let uses_exe = det.matched_lines.iter().any(|m| m.content.contains(".exe"));
+ if uses_exe {
+ writeln!(
+ out,
+ "{}",
+ hint_message(cformat!(
+ "Creates shell function <bold>{cmd}</>. Aliases should use <bright-black>{cmd}</>, not <bright-black>{cmd}.exe</>"
+ ))
+ )?;
+ }
}
// Check if zsh has compinit enabled (required for completions)
@@ -626,14 +626,57 @@ fn render_shell_status(out: &mut String) -> anyhow::Result<()> {
for detected in &detection.unmatched_candidates {
writeln!(out, "{}", format_bash_with_gutter(detected.content.trim()))?;
}
+
+ // If any unmatched lines contain .exe, explain the function name issue
+ let uses_exe = detection
+ .unmatched_candidates
+ .iter()
+ .any(|m| m.content.contains(".exe"));
+ if uses_exe {
+ writeln!(
+ out,
+ "{}",
+ hint_message(cformat!(
+ "Note: <bold>{cmd}.exe</> creates shell function <bold>{cmd}</>. \
+ Aliases should use <bright-black>{cmd}</>, not <bright-black>{cmd}.exe</>"
+ ))
+ )?;
+ }
}
}
- // If we have unmatched candidates but no configured shells, suggest raising an issue
+ // Show aliases that bypass shell integration (Issue #348)
+ for detection in &detection_results {
+ for alias in &detection.bypass_aliases {
+ let path = format_path_for_display(&detection.path);
+ let location = format!("{}:{}", path, alias.line_number);
+ writeln!(
+ out,
+ "{}",
+ warning_message(cformat!(
+ "Alias <bold>{}</> bypasses shell integration — won't auto-cd",
+ alias.alias_name
+ ))
+ )?;
+ writeln!(out, "{}", format_bash_with_gutter(alias.content.trim()))?;
+ writeln!(
+ out,
+ "{}",
+ hint_message(cformat!(
+ "Change to <bright-black>alias {}=\"{cmd}\"</> @ {location}",
+ alias.alias_name
+ ))
+ )?;
+ }
+ }
+
+ // Check if any shell has config already (eval line present)
let has_any_configured = scan_result
.configured
.iter()
.any(|r| matches!(r.action, ConfigAction::AlreadyExists));
+
+ // If we have unmatched candidates but no configured shells, suggest raising an issue
if has_any_unmatched && !has_any_configured {
let unmatched_summary: Vec<_> = detection_results
.iter()
diff --git a/src/output/shell_integration.rs b/src/output/shell_integration.rs
index be956828a..07810c526 100644
--- a/src/output/shell_integration.rs
+++ b/src/output/shell_integration.rs
@@ -64,6 +64,9 @@ use worktrunk::shell::{Shell, extract_filename_from_path};
use worktrunk::styling::hint_message;
/// Shell integration install hint message.
+// TODO(hints-count): After showing this hint 5+ times, suggest `wt config show` for diagnostics.
+// This requires changing the hints infrastructure to track counts rather than booleans.
+// See `Repository::mark_hint_shown()` and `list_shown_hints()` in src/git/repository/mod.rs.
pub(crate) fn shell_integration_hint() -> String {
cformat!("To enable automatic cd, run <bright-black>wt config shell install</>")
}
diff --git a/src/shell.rs b/src/shell.rs
index ffa803ec6..6d8fcc9c1 100644
--- a/src/shell.rs
+++ b/src/shell.rs
@@ -144,28 +144,47 @@ fn has_init_invocation(line: &str, cmd: &str) -> bool {
}
/// Check if line has the init pattern, with prefix exclusion for non-git-wt commands.
+///
+/// Handles Windows `.exe` suffix: searches for both `{cmd} config shell init` and
+/// `{cmd}.exe config shell init` to match lines like:
+/// ```text
+/// eval "$(git-wt.exe config shell init bash)"
+/// ```
fn has_init_pattern_with_prefix_check(line: &str, cmd: &str) -> bool {
- let init_pattern = format!("{cmd} config shell init");
+ // Search for both plain command and .exe variant (Windows Git Bash)
+ let patterns = [
+ format!("{cmd} config shell init"),
+ format!("{cmd}.exe config shell init"),
+ ];
- // Find all occurrences of the pattern
- let mut search_start = 0;
- while let Some(pos) = line[search_start..].find(&init_pattern) {
- let absolute_pos = search_start + pos;
+ for init_pattern in &patterns {
+ // Determine the command portion for position checking
+ // For ".exe" pattern, the command in the line includes ".exe"
+ let cmd_in_line = if init_pattern.contains(".exe") {
+ format!("{cmd}.exe")
+ } else {
+ cmd.to_string()
+ };
- // Check what precedes the match
- if is_valid_command_position(line, absolute_pos, cmd) {
- // Must be in an execution context
- if line.contains("eval")
- || line.contains("source")
- || line.contains("Invoke-Expression")
- || line.contains("if ")
- {
- return true;
+ let mut search_start = 0;
+ while let Some(pos) = line[search_start..].find(init_pattern.as_str()) {
+ let absolute_pos = search_start + pos;
+
+ // Check what precedes the match
+ if is_valid_command_position(line, absolute_pos, &cmd_in_line) {
+ // Must be in an execution context
+ if line.contains("eval")
+ || line.contains("source")
+ || line.contains("Invoke-Expression")
+ || line.contains("if ")
+ {
+ return true;
+ }
}
- }
- // Continue searching after this match
- search_start = absolute_pos + 1;
+ // Continue searching after this match
+ search_start = absolute_pos + 1;
+ }
}
false
@@ -186,9 +205,9 @@ fn is_valid_command_position(line: &str, pos: usize, cmd: &str) -> bool {
let before = &line[..pos];
- // For git-wt, just check it's not part of a longer identifier
+ // For git-wt (and git-wt.exe), just check it's not part of a longer identifier
// e.g., `my-git-wt` should not match
- if cmd == "git-wt" {
+ if cmd == "git-wt" || cmd == "git-wt.exe" {
let last_char = before.chars().last().unwrap();
return !last_char.is_alphanumeric() && last_char != '_' && last_char != '-';
}
@@ -256,6 +275,22 @@ pub struct FileDetectionResult {
/// Lines containing the command at word boundary but NOT detected.
/// These are potential false negatives.
pub unmatched_candidates: Vec<DetectedLine>,
+ /// Aliases that bypass shell integration by pointing to a binary path.
+ /// e.g., `alias gwt="/usr/bin/wt"` or `alias wt="wt.exe"`
+ pub bypass_aliases: Vec<BypassAlias>,
+}
+
+/// An alias that bypasses shell integration by pointing to a binary.
+#[derive(Debug, Clone)]
+pub struct BypassAlias {
+ /// Line number in the config file (1-indexed).
+ pub line_number: usize,
+ /// The alias name (e.g., "gwt").
+ pub alias_name: String,
+ /// The target the alias points to (e.g., "/usr/bin/wt" or "wt.exe").
+ pub target: String,
+ /// The full line content.
+ pub content: String,
}
/// Scan a single file for shell integration lines and potential false negatives.
@@ -267,6 +302,7 @@ fn scan_file(path: &std::path::Path, cmd: &str) -> Option<FileDetectionResult> {
let reader = BufReader::new(file);
let mut matched_lines = Vec::new();
let mut unmatched_candidates = Vec::new();
+ let mut bypass_aliases = Vec::new();
for (line_number, line) in reader.lines().map_while(Result::ok).enumerate() {
let line_number = line_number + 1; // 1-based
@@ -287,10 +323,18 @@ fn scan_file(path: &std::path::Path, cmd: &str) -> Option<FileDetectionResult> {
content: line.clone(),
});
}
+
+ // Check for aliases that bypass shell integration
+ if let Some(alias) = detect_bypass_alias(trimmed, cmd, line_number) {
+ bypass_aliases.push(BypassAlias {
+ content: line.clone(),
+ ..alias
+ });
+ }
}
// Only return if we found something interesting
- if matched_lines.is_empty() && unmatched_candidates.is_empty() {
+ if matched_lines.is_empty() && unmatched_candidates.is_empty() && bypass_aliases.is_empty() {
return None;
}
@@ -298,6 +342,80 @@ fn scan_file(path: &std::path::Path, cmd: &str) -> Option<FileDetectionResult> {
path: path.to_path_buf(),
matched_lines,
unmatched_candidates,
+ bypass_aliases,
+ })
+}
+
+/// Detect if a line defines an alias that bypasses shell integration.
+///
+/// Returns `Some(BypassAlias)` if the line is an alias pointing to a binary path.
+/// Binary paths are detected by: containing `/` or `\`, or ending with `.exe`.
+///
+/// Examples that bypass:
+/// - `alias gwt="/usr/bin/wt"` — absolute path
+/// - `alias wt="wt.exe"` — Windows binary
+/// - `alias gwt='git-wt.exe'` — Windows binary with single quotes
+///
+/// Examples that don't bypass:
+/// - `alias gwt="wt"` — points to function name (OK)
+/// - `alias gwt="git-wt"` — points to function name (OK)
+fn detect_bypass_alias(line: &str, cmd: &str, line_number: usize) -> Option<BypassAlias> {
+ // Match patterns like: alias <name>="<target>" or alias <name>='<target>'
+ // Also handle: alias <name>=<target> (no quotes, less common)
+ let line = line.trim();
+
+ // Must start with "alias "
+ if !line.starts_with("alias ") {
+ return None;
+ }
+
+ let after_alias = line[6..].trim_start();
+
+ // Find the = sign
+ let eq_pos = after_alias.find('=')?;
+ let alias_name = after_alias[..eq_pos].trim();
+ let target_part = after_alias[eq_pos + 1..].trim();
+
+ // Extract target, handling quotes
+ let target = if let Some(stripped) = target_part.strip_prefix('"') {
+ // Double-quoted: find closing quote
+ let end = stripped.find('"')?;
+ &stripped[..end]
+ } else if let Some(stripped) = target_part.strip_prefix('\'') {
+ // Single-quoted: find closing quote
+ let end = stripped.find('\'')?;
+ &stripped[..end]
+ } else {
+ // Unquoted: take until whitespace or end
+ target_part.split_whitespace().next()?
+ };
+
+ // Check if target looks like a binary path (contains path separators or .exe)
+ let target_lower = target.to_ascii_lowercase();
+ let is_binary_target =
+ target.contains('/') || target.contains('\\') || target_lower.ends_with(".exe");
+
+ if !is_binary_target {
+ return None;
+ }
+
+ // Check if the target references our command (wt, git-wt, etc.)
+ // We check if target contains the cmd name to catch:
+ // - /usr/bin/wt
+ // - wt.exe
+ // - /path/to/git-wt
+ // - git-wt.exe
+ let target_lower = target.to_ascii_lowercase();
+ let cmd_lower = cmd.to_ascii_lowercase();
+ if !target_lower.contains(&cmd_lower) {
+ return None;
+ }
+
+ Some(BypassAlias {
+ line_number,
+ alias_name: alias_name.to_string(),
+ target: target.to_string(),
+ content: String::new(), // Filled in by caller
})
}
@@ -1052,6 +1170,62 @@ mod tests {
);
}
+ // ==========================================================================
+ // Windows .exe suffix tests (Issue #348)
+ // ==========================================================================
+
+ /// Windows Git Bash users may have .exe in their config lines.
+ /// Detection should match both `git-wt config shell init` and `git-wt.exe config shell init`.
+ #[rstest]
+ #[case::wt_exe_basic(r#"eval "$(wt.exe config shell init bash)""#, "wt", true)]
+ #[case::wt_exe_with_command(r#"eval "$(command wt.exe config shell init bash)""#, "wt", true)]
+ #[case::git_wt_exe_basic(r#"eval "$(git-wt.exe config shell init bash)""#, "git-wt", true)]
+ #[case::git_wt_exe_with_command(
+ r#"eval "$(command git-wt.exe config shell init bash)""#,
+ "git-wt",
+ true
+ )]
+ #[case::git_wt_exe_with_if(
+ r#"if command -v git-wt.exe &> /dev/null; then eval "$(command git-wt.exe config shell init bash)"; fi"#,
+ "git-wt",
+ true
+ )]
+ // Issue #348: exact pattern from user's dotfiles
+ #[case::issue_348_exact(
+ r#"eval "$(command git-wt.exe config shell init bash)""#,
+ "git-wt",
+ true
+ )]
+ fn test_windows_exe_suffix(#[case] line: &str, #[case] cmd: &str, #[case] should_match: bool) {
+ assert_eq!(
+ is_shell_integration_line(line, cmd),
+ should_match,
+ "Windows .exe test failed\nLine: {line}\nCommand: {cmd}\nExpected: {should_match}"
+ );
+ }
+
+ /// .exe should NOT cause false positives for different commands
+ #[rstest]
+ #[case::wt_exe_not_git_wt(r#"eval "$(wt.exe config shell init bash)""#, "git-wt", false)]
+ #[case::git_wt_exe_not_wt(r#"eval "$(git-wt.exe config shell init bash)""#, "wt", false)]
+ // Prefixed command with .exe should not match
+ #[case::my_git_wt_exe_not_git_wt(
+ r#"eval "$(my-git-wt.exe config shell init bash)""#,
+ "git-wt",
+ false
+ )]
+ fn test_windows_exe_no_false_positives(
+ #[case] line: &str,
+ #[case] cmd: &str,
+ #[case] should_match: bool,
+ ) {
+ assert_eq!(
+ is_shell_integration_line(line, cmd),
+ should_match,
+ "Windows .exe false positive check failed\nLine: {line}\nCommand: {cmd}\nExpected: {should_match}"
+ );
+ }
+
/// Word boundary: `newt` should not match `wt`
#[test]
fn test_word_boundary_newt() {
@@ -1410,4 +1584,65 @@ mod tests {
// - Warning message before shell restart ("not installed" vs "restart to activate")
// - `wt config shell uninstall` (lines might not be found)
// ------------------------------------------------------------------------
+
+ // ==========================================================================
+ // ALIAS BYPASS DETECTION TESTS (Issue #348)
+ // ==========================================================================
+
+ /// Aliases pointing to binary paths should be detected as bypassing shell integration
+ #[rstest]
+ #[case::absolute_path(r#"alias gwt="/usr/bin/wt""#, "wt", "gwt", "/usr/bin/wt")]
+ #[case::exe_suffix(r#"alias gwt="wt.exe""#, "wt", "gwt", "wt.exe")]
+ #[case::exe_with_path(r#"alias gwt="/path/to/wt.exe""#, "wt", "gwt", "/path/to/wt.exe")]
+ #[case::single_quotes(r#"alias gwt='/usr/bin/wt'"#, "wt", "gwt", "/usr/bin/wt")]
+ #[case::git_wt_exe(r#"alias gwt="git-wt.exe""#, "git-wt", "gwt", "git-wt.exe")]
+ #[case::windows_path(
+ r#"alias gwt="C:\Program Files\wt\wt.exe""#,
+ "wt",
+ "gwt",
+ r"C:\Program Files\wt\wt.exe"
+ )]
+ fn test_bypass_alias_detected(
+ #[case] line: &str,
+ #[case] cmd: &str,
+ #[case] expected_name: &str,
+ #[case] expected_target: &str,
+ ) {
+ let result = detect_bypass_alias(line, cmd, 1);
+ assert!(
+ result.is_some(),
+ "Expected bypass alias detection for: {line}"
+ );
+ let alias = result.unwrap();
+ assert_eq!(alias.alias_name, expected_name);
+ assert_eq!(alias.target, expected_target);
+ }
+
+ /// Aliases pointing to function names (not paths) should NOT be detected as bypassing
+ #[rstest]
+ #[case::function_name(r#"alias gwt="wt""#, "wt")]
+ #[case::git_wt_function(r#"alias gwt="git-wt""#, "git-wt")]
+ #[case::other_alias(r#"alias ll="ls -la""#, "wt")]
+ #[case::not_an_alias("eval \"$(wt config shell init bash)\"", "wt")]
+ #[case::commented_alias(r#"# alias gwt="/usr/bin/wt""#, "wt")]
+ fn test_bypass_alias_not_detected(#[case] line: &str, #[case] cmd: &str) {
+ // Note: commented lines are skipped in scan_file, but detect_bypass_alias
+ // itself doesn't filter comments - that's done by the caller
+ let result = detect_bypass_alias(line, cmd, 1);
+ // For commented alias, we test the raw function behavior
+ if !line.trim().starts_with('#') {
+ assert!(
+ result.is_none(),
+ "Should NOT detect bypass for: {line}, got: {:?}",
+ result
+ );
+ }
+ }
+
+ /// Unrelated aliases should not be detected
+ #[test]
+ fn test_unrelated_alias_not_detected() {
+ let result = detect_bypass_alias(r#"alias vim="nvim""#, "wt", 1);
+ assert!(result.is_none());
+ }
}
diff --git a/tests/CLAUDE.md b/tests/CLAUDE.md
index 68e88b5d7..ea3d99361 100644
--- a/tests/CLAUDE.md
+++ b/tests/CLAUDE.md
@@ -106,6 +106,38 @@ assert!(!marker_file.exists(), "Command should NOT have run");
Use `--yes` to skip interactive prompts in tests. Don't pipe input to stdin.
+## Feature Flags, Not Runtime Skipping
+
+**Never skip tests based on runtime availability checks.** Use Cargo feature flags instead.
+
+```rust
+// ❌ BAD: Runtime skip - test silently passes when tool unavailable
+#[test]
+fn test_fish_integration() {
+ if !shell_available("fish") {
+ eprintln!("Skipping: fish not available");
+ return;
+ }
+ // test code...
+}
+
+// ✅ GOOD: Feature flag - test excluded from compilation
+#[cfg(feature = "shell-integration-tests")]
+#[test]
+fn test_fish_integration() {
+ // test code...
+}
+```
+
+**Why:**
+- Runtime skips hide missing test coverage in CI logs
+- Feature flags make dependencies explicit in `Cargo.toml`
+- `cargo test` output clearly shows which tests ran vs were compiled out
+- CI can enable features when dependencies are installed
+
+**Existing feature flags:**
+- `shell-integration-tests` — Tests requiring bash/zsh/fish shells and PTY
+
## README Examples and Snapshot Testing
### Problem: Separated stdout/stderr in Standard Snapshots
diff --git a/tests/common/mod.rs b/tests/common/mod.rs
index 88c078cba..9f6a1e59e 100644
--- a/tests/common/mod.rs
+++ b/tests/common/mod.rs
@@ -2103,23 +2103,31 @@ fn setup_snapshot_settings_for_paths(
// On Windows, clap shows "wt.exe" instead of "wt"
settings.add_filter(r"wt\.exe", "wt");
- // Normalize version strings in `wt config show` RUNTIME section
+ // Normalize version strings in `wt config show` OTHER section (formerly RUNTIME)
// Version can be: v0.8.5, v0.8.5-2-gabcdef, v0.8.5-dirty, or bare git hash (b9ffe83)
- // New format: version as suffix to RUNTIME heading (e.g., "RUNTIME wt v0.9.0")
- // Pattern: <cyan>RUNTIME</cyan> wt VERSION
+ // Format: "OTHER wt v0.9.0" with cyan ANSI codes around OTHER
+ // Pattern: <cyan>OTHER</cyan> wt VERSION
settings.add_filter(
- r"(RUNTIME\x1b\[39m wt )(?:v[0-9]+\.[0-9]+\.[0-9]+(?:-[0-9]+-g[0-9a-f]+)?(?:-dirty)?|[0-9a-f]{7,40})",
+ r"(OTHER\x1b\[39m wt )(?:v[0-9]+\.[0-9]+\.[0-9]+(?:-[0-9]+-g[0-9a-f]+)?(?:-dirty)?|[0-9a-f]{7,40})",
"${1}[VERSION]",
);
- // Normalize project root paths in "Invoked as:" debug output
+ // Normalize project root paths in "Binary invoked as:" debug output
// Tests run cargo which produces paths like /path/to/worktrunk/target/debug/wt
// Normalize to [PROJECT_ROOT]/target/debug/wt for deterministic snapshots
settings.add_filter(
- r"(Invoked as: \x1b\[1m)[^\x1b]+/target/(debug|release)/wt(\x1b\[22m)",
+ r"(Binary invoked as: \x1b\[1m)[^\x1b]+/target/(debug|release)/wt(\x1b\[22m)",
"${1}[PROJECT_ROOT]/target/$2/wt$3",
);
+ // Normalize shell probe binary paths
+ // Shell probe reports the actual binary location which varies by system
+ // Format: "is binary at <bold>PATH</>, not function"
+ settings.add_filter(
+ r"(is binary at \x1b\[1m)[^\x1b]+(/wt|/wt\.exe)(\x1b\[22m)",
+ "${1}[BINARY_PATH]$2$3",
+ );
+
// Remove trailing ANSI reset codes at end of lines for cross-platform consistency
// Windows terminal strips these trailing resets that Unix includes
settings.add_filter(r"\x1b\[0m$", "");
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_claude_available_plugin_not_installed.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_claude_available_plugin_not_installed.snap
index 739ff7baf..ba969a143 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_claude_available_plugin_not_installed.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_claude_available_plugin_not_installed.snap
@@ -39,13 +39,14 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed. To install, run:
  claude plugin marketplace add max-sixty/worktrunk
  claude plugin install worktrunk@worktrunk
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_empty_project_config.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_empty_project_config.snap
index 10fe2b42b..2ec8a9991 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_empty_project_config.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_empty_project_config.snap
@@ -39,12 +39,13 @@ exit_code: 0
↳ Empty file
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_full_command_not_found.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_full_command_not_found.snap
index c20a1136f..e2df69f13 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_full_command_not_found.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_full_command_not_found.snap
@@ -44,6 +44,9 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
@@ -56,8 +59,6 @@ exit_code: 0
  ○ Ran command:
    nonexistent-llm-command-12345 -m test-model
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_full_not_configured.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_full_not_configured.snap
index 2af9b2386..bfc7aa159 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_full_not_configured.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_full_not_configured.snap
@@ -40,6 +40,9 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
@@ -48,8 +51,6 @@ exit_code: 0
↳ CI status requires GitHub or GitLab remote
↳ Commit generation not configured
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_github_remote.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_github_remote.snap
index 2d4d47b94..b0bdb613c 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_github_remote.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_github_remote.snap
@@ -39,12 +39,13 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_gitlab_remote.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_gitlab_remote.snap
index 2d4d47b94..b0bdb613c 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_gitlab_remote.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_gitlab_remote.snap
@@ -39,12 +39,13 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_no_project_config.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_no_project_config.snap
index 2d4d47b94..b0bdb613c 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_no_project_config.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_no_project_config.snap
@@ -39,12 +39,13 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_no_user_config.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_no_user_config.snap
index 192976cdc..4c3058f30 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_no_user_config.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_no_user_config.snap
@@ -39,12 +39,13 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_outside_git_repo.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_outside_git_repo.snap
index 158ea6edd..137988e48 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_outside_git_repo.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_outside_git_repo.snap
@@ -31,12 +31,13 @@ exit_code: 0
PROJECT CONFIG Not in a git repository
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_partial_shell_config_shows_hint.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_partial_shell_config_shows_hint.snap
index 5cd5c1c8b..b40909d50 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_partial_shell_config_shows_hint.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_partial_shell_config_shows_hint.snap
@@ -40,6 +40,9 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
↳ Not configured shell extension & completions for bash @ ~/.bashrc
○ Already configured shell extension & completions for zsh @ ~/.zshrc:2
  if command -v wt >/dev/null 2>&1; then eval "$(command wt config shell init zsh)"; fi
@@ -47,8 +50,6 @@ exit_code: 0
↳ To enable shell integration, run wt config shell install
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_plugin_installed.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_plugin_installed.snap
index 4cf2f2589..3b63401f6 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_plugin_installed.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_plugin_installed.snap
@@ -39,12 +39,13 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
✓ Claude Code plugin installed
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_shell_integration_active.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_shell_integration_active.snap
index 4845196bb..7fc14535e 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_shell_integration_active.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_shell_integration_active.snap
@@ -40,12 +40,12 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+○ Shell integration active
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-○ Shell integration active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_unmatched_candidate_warning.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_unmatched_candidate_warning.snap
index ec924f95a..f6ce555c0 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_unmatched_candidate_warning.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_unmatched_candidate_warning.snap
@@ -40,6 +40,9 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
↳ Not configured shell extension & completions for bash @ ~/.bashrc
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
@@ -50,8 +53,6 @@ exit_code: 0
↳ If this is shell integration, report a false negative: https://github.com/max-sixty/worktrunk/issues/new?title=Shell%20integration%20detection%20false%20negative&body=Shell%20integration%20not%20detected%20despite%20config%20containing%20%60wt%60.%0A%0A%2A%2AUnmatched%20lines%3A%2A%2A%0A%60%60%60%0Aalias%20wt%3D%22git%20worktree%22%0A%60%60%60%0A%0A%2A%2AExpected%20behavior%3A%2A%2A%20These%20lines%20should%20be%20detected%20as%20shell%20integration.
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_warns_unknown_project_keys.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_warns_unknown_project_keys.snap
index 4743daacf..cbd4d0aae 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_warns_unknown_project_keys.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_warns_unknown_project_keys.snap
@@ -41,12 +41,13 @@ exit_code: 0
  deploy = "task deploy"
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_warns_unknown_user_keys.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_warns_unknown_user_keys.snap
index daaef3641..97cea6c30 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_warns_unknown_user_keys.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_warns_unknown_user_keys.snap
@@ -43,12 +43,13 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_whitespace_only_project_config.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_whitespace_only_project_config.snap
index 10fe2b42b..2ec8a9991 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_whitespace_only_project_config.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_whitespace_only_project_config.snap
@@ -39,12 +39,13 @@ exit_code: 0
↳ Empty file
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_with_project_config.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_with_project_config.snap
index 39c27bdf4..4141527d0 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_with_project_config.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_with_project_config.snap
@@ -45,12 +45,13 @@ exit_code: 0
  server = "npm run dev"
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Skipped bash; ~/.bashrc not found
○ Skipped zsh; ~/.zshrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_zsh_compinit_correct_order.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_zsh_compinit_correct_order.snap
index bcd8f84a0..a01a1e7de 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_zsh_compinit_correct_order.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_zsh_compinit_correct_order.snap
@@ -40,13 +40,14 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Already configured shell extension & completions for zsh @ ~/.zshrc:5
  if command -v wt >/dev/null 2>&1; then eval "$(command wt config shell init zsh)"; fi
○ Skipped bash; ~/.bashrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive
diff --git a/tests/snapshots/integration__integration_tests__config_show__config_show_zsh_compinit_warning.snap b/tests/snapshots/integration__integration_tests__config_show__config_show_zsh_compinit_warning.snap
index 59c39247a..964aa8e7c 100644
--- a/tests/snapshots/integration__integration_tests__config_show__config_show_zsh_compinit_warning.snap
+++ b/tests/snapshots/integration__integration_tests__config_show__config_show_zsh_compinit_warning.snap
@@ -40,6 +40,9 @@ exit_code: 0
↳ Not found
SHELL INTEGRATION
+▲ Shell integration not active
+  Binary invoked as: [PROJECT_ROOT]/target/debug/wt
+
○ Already configured shell extension & completions for zsh @ ~/.zshrc:2
  if command -v wt >/dev/null 2>&1; then eval "$(command wt config shell init zsh)"; fi
▲ Completions won't work; add to ~/.zshrc before the wt line:
@@ -47,8 +50,6 @@ exit_code: 0
○ Skipped bash; ~/.bashrc not found
○ Skipped fish; ~/.config/fish/conf.d not found
-RUNTIME wt [VERSION]
-▲ Shell integration not active
-  Invoked as: [PROJECT_ROOT]/target/debug/wt
+OTHER wt [VERSION]
↳ Claude Code plugin not installed (claude not found)
○ Hyperlinks: inactive