Skip to content

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

Make named alias inspection work outside repositories (#4547)

Maximilian Roosbf0894cb977a
diff --git a/src/commands/alias.rs b/src/commands/alias.rs
index 2712fca02..71ebef285 100644
--- a/src/commands/alias.rs
+++ b/src/commands/alias.rs
@@ -877,7 +877,7 @@ fn render_aliases_help_section(
/// separately preserves the individual command text; merging them would
/// reduce to an uninformative step count when both are unnamed singles.
///
-/// Callers (`augment_help`, `wt config alias show` with no name) latch
+/// Callers (`augment_help`, `wt config alias show`) latch
/// `suppress_warnings()` before reaching here so the standard `UserConfig::load()`
/// stays quiet: no deprecation warnings, no `.new` file writes, no
/// approved-commands copy. Project config is parsed directly from TOML rather
diff --git a/src/commands/config/alias.rs b/src/commands/config/alias.rs
index acde519e7..d38c7efe6 100644
--- a/src/commands/config/alias.rs
+++ b/src/commands/config/alias.rs
@@ -40,82 +40,42 @@ use crate::commands::command_executor::{
use worktrunk::config::HookSource;
use worktrunk::utils::did_you_mean;
-/// Show the configured template(s) for an alias — or, with no name, every
-/// configured alias's template(s).
+/// Show configured alias templates, optionally restricted to one name.
///
-/// When the same name is defined in both user and project config, both
-/// entries are printed (user first, matching runtime execution order).
+/// Both forms are discovery surfaces: tolerate running outside a repository,
+/// suppress config migration warnings, and page long definitions. Entries are
+/// ordered by name, then user before project, matching runtime execution order.
pub fn handle_alias_show(name: Option<String>) -> anyhow::Result<()> {
- let Some(name) = name else {
- return list_aliases();
- };
-
- let repo = Repository::current()?;
- let user_config = repo.user_config();
- let project_config = repo.project_config()?;
- let entries = entries_for_name(&repo, user_config, project_config, &name);
-
- if entries.is_empty() {
- return Err(unknown_alias_error(
- &repo,
- user_config,
- project_config,
- &name,
- "show",
- ));
- }
-
- warn_if_shadowed(&name);
-
- for (cfg, source) in &entries {
- let bodies: Vec<String> = cfg.commands().map(|c| c.template.clone()).collect();
- println!("{}", format_entry(&name, cfg, *source, &bodies, None));
- }
- Ok(())
-}
-
-/// Show every configured alias's full definition — the same header + gutter
-/// block `wt config alias show <name>` prints, emitted for each alias in name
-/// order (and for each source when a name is defined in both, user first,
-/// matching runtime execution order). `wt --help` shows a compact names-only
-/// list (`render_aliases_help_section`) and points here for these.
-///
-/// Tolerates running outside a repository (user-config aliases still list,
-/// project-config ones are skipped) and outside a config (prints a note).
-/// Warnings are suppressed: this is a discovery surface, so a deprecated
-/// `wt.toml` shouldn't make `wt config alias show` noisy — `wt config update`
-/// is where deprecations get reported. A name shadowed by a top-level
-/// built-in still gets the same stderr warning `wt config alias show <name>`
-/// emits, once per name.
-fn list_aliases() -> anyhow::Result<()> {
worktrunk::config::suppress_warnings();
- let entries = load_aliases_for_listing();
+ let mut entries = load_aliases_for_listing();
+ if let Some(name) = name {
+ if !entries.iter().any(|(n, _, _)| n == &name) {
+ return Err(unknown_alias_error(
+ &name,
+ "show",
+ entries.into_iter().map(|(n, _, _)| n).collect(),
+ ));
+ }
+ entries.retain(|(n, _, _)| n == &name);
+ }
if entries.is_empty() {
println!("{}", info_message("No aliases configured"));
return Ok(());
}
- // `entries` is sorted by (name, source), so a name's entries are adjacent.
- // Warn once per shadowed name — matching `show <name>`, which warns on the
- // name, not per entry. The `Aliases:` names are invoked as `wt <name>`, so
- // shadowing is judged from the top-level perspective (an alias named `list`
- // is unreachable; one named `commit` is not — `wt commit` runs it).
+ // Duplicate names from user and project config need only one warning.
let mut prev_name: Option<&str> = None;
- for (name, _, _) in &entries {
+ let mut out = String::new();
+ for (name, cfg, source) in &entries {
if prev_name != Some(name.as_str()) {
warn_if_shadowed(name);
prev_name = Some(name);
}
- }
-
- let mut out = String::new();
- for (name, cfg, source) in &entries {
let bodies: Vec<String> = cfg.commands().map(|c| c.template.clone()).collect();
out.push_str(&format_entry(name, cfg, *source, &bodies, None));
out.push('\n');
}
- crate::help_pager::show_help_in_pager(&out, true)?;
- Ok(())
+ crate::help_pager::show_help_in_pager(&out, true)
}
/// Emit a warning if `name` is a top-level built-in subcommand. Aliases with
@@ -149,11 +109,11 @@ pub fn handle_alias_dry_run(name: String, args: Vec<String>) -> anyhow::Result<(
if entries.is_empty() {
return Err(unknown_alias_error(
- &repo,
- user_config,
- project_config,
&name,
"dry-run",
+ load_aliases(Some(&repo), user_config, project_config)
+ .into_keys()
+ .collect(),
));
}
@@ -285,15 +245,8 @@ fn entries_for_name(
/// Returns `AlreadyDisplayed { exit_code: 2 }` rather than calling
/// `process::exit`, so `main`'s `finish_command` still runs `terminate_output`
/// (ANSI reset for shell integration) and `diagnostic::write_if_verbose`.
-fn unknown_alias_error(
- repo: &Repository,
- user_config: &UserConfig,
- project_config: Option<&ProjectConfig>,
- name: &str,
- sub: &str,
-) -> anyhow::Error {
- let aliases = load_aliases(Some(repo), user_config, project_config);
- let suggestions = did_you_mean(name, aliases.into_keys());
+fn unknown_alias_error(name: &str, sub: &str, aliases: BTreeSet<String>) -> anyhow::Error {
+ let suggestions = did_you_mean(name, aliases);
let mut top = crate::cli::build_command();
let sub_cmd = top
diff --git a/src/main.rs b/src/main.rs
index 87dd71e44..6f0fefb7c 100644
--- a/src/main.rs
+++ b/src/main.rs
@@ -903,11 +903,13 @@ fn handle_merge_command(args: MergeArgs, yes: bool) -> anyhow::Result<()> {
}
/// True when the parsed command should silence prewarm-time deprecation
-/// warnings. Two reasons qualify:
+/// warnings. These surfaces qualify:
///
/// - **TUI / stderr-sensitive output** (`select`, `switch` picker mode,
/// `list statusline`) — warnings on stderr would land above the picker
/// or shell prompt and visually break it.
+/// - **Alias discovery** (`config alias show`) — definitions remain readable
+/// without unrelated config migration warnings.
/// - **`config update`** — the handler renders the deprecations and a diff
/// itself, so the prewarm-time warning + `wt config update` hint is
/// redundant noise above its own UI.
@@ -924,7 +926,11 @@ fn command_suppresses_warnings(command: Option<&Commands>) -> bool {
matches!(args.subcommand, Some(ListSubcommand::Statusline { .. }))
}
Some(Commands::Config {
- action: ConfigCommand::Update { .. },
+ action:
+ ConfigCommand::Update { .. }
+ | ConfigCommand::Alias {
+ action: ConfigAliasCommand::Show { .. },
+ },
}) => true,
_ => false,
}
diff --git a/tests/integration_tests/step_alias.rs b/tests/integration_tests/step_alias.rs
index 8c2df97d1..7fe3321ab 100644
--- a/tests/integration_tests/step_alias.rs
+++ b/tests/integration_tests/step_alias.rs
@@ -1897,6 +1897,56 @@ greet = "echo hi {{ branch }}"
));
}
+/// User alias discovery does not require a Git repository, with or without a
+/// name. A typo still gets alias suggestions rather than a repository error.
+#[rstest]
+fn test_config_alias_show_outside_repository(repo: TestRepo) {
+ let outside = crate::common::test_tempdir();
+ repo.write_test_config(
+ r#"
+[aliases]
+deploy = "echo {{ branch }}"
+"#,
+ );
+ let settings = setup_snapshot_settings(&repo);
+ let _guard = settings.bind_to_scope();
+
+ for (snapshot, args) in [
+ ("alias_show_outside_all", vec!["alias", "show"]),
+ ("alias_show_outside_named", vec!["alias", "show", "deploy"]),
+ ("alias_show_outside_typo", vec!["alias", "show", "deplyo"]),
+ ] {
+ assert_cmd_snapshot!(
+ snapshot,
+ make_snapshot_cmd(&repo, "config", &args, Some(outside.path()))
+ );
+ }
+}
+
+/// Discovery stays quiet even when prewarm reads a deprecated user setting.
+#[rstest]
+fn test_config_alias_show_suppresses_deprecation_warnings(repo: TestRepo) {
+ repo.write_test_config(
+ r#"
+[aliases]
+deploy = "echo hi"
+[commit-generation]
+command = "echo message"
+"#,
+ );
+ let settings = setup_snapshot_settings(&repo);
+ let _guard = settings.bind_to_scope();
+ for (snapshot, args) in [
+ ("alias_show_deprecated_all", vec!["alias", "show"]),
+ (
+ "alias_show_deprecated_named",
+ vec!["alias", "show", "deploy"],
+ ),
+ ] {
+ assert_cmd_snapshot!(snapshot, make_snapshot_cmd(&repo, "config", &args, None));
+ }
+}
+
/// `wt config alias show` with no name and no aliases configured prints a note
/// rather than empty output.
#[rstest]
diff --git a/tests/snapshots/integration__integration_tests__step_alias__alias_show_deprecated_all.snap b/tests/snapshots/integration__integration_tests__step_alias__alias_show_deprecated_all.snap
new file mode 100644
index 000000000..75d89631d
--- /dev/null
+++ b/tests/snapshots/integration__integration_tests__step_alias__alias_show_deprecated_all.snap
@@ -0,0 +1,64 @@
+---
+source: tests/integration_tests/step_alias.rs
+info:
+ program: wt
+ args:
+ - config
+ - alias
+ - show
+ env:
+ APPDATA: "[TEST_CONFIG_HOME]"
+ CLAUDE_CONFIG_DIR: "[TEST_CLAUDE_CONFIG]"
+ CLICOLOR_FORCE: "1"
+ COLUMNS: "500"
+ GIT_ALLOW_PROTOCOL: file
+ GIT_AUTHOR_DATE: "2025-01-01T00:00:00Z"
+ GIT_AUTHOR_EMAIL: [email protected]
+ GIT_AUTHOR_NAME: Test User
+ GIT_COMMITTER_DATE: "2025-01-01T00:00:00Z"
+ GIT_COMMITTER_EMAIL: [email protected]
+ GIT_COMMITTER_NAME: Test User
+ GIT_CONFIG_COUNT: "2"
+ GIT_CONFIG_GLOBAL: /nonexistent/wt/gitconfig
+ GIT_CONFIG_KEY_0: user.useConfigOnly
+ GIT_CONFIG_KEY_1: rerere.enabled
+ GIT_CONFIG_SYSTEM: /nonexistent/wt/gitconfig
+ GIT_CONFIG_VALUE_0: "true"
+ GIT_CONFIG_VALUE_1: "false"
+ GIT_TERMINAL_PROMPT: "0"
+ HOME: "[TEST_HOME]"
+ LANG: C
+ LC_ALL: C
+ LLVM_PROFILE_FILE: "[LLVM_PROFILE_FILE]"
+ OPENCODE_CONFIG_DIR: "[TEST_OPENCODE_CONFIG]"
+ PATH: "[PATH]"
+ TERM: alacritty
+ USERPROFILE: "[TEST_HOME]"
+ WORKTRUNK_APPROVALS_PATH: "[TEST_APPROVALS]"
+ WORKTRUNK_CONFIG_PATH: "[TEST_CONFIG]"
+ WORKTRUNK_SYSTEM_CONFIG_PATH: "[TEST_SYSTEM_CONFIG]"
+ WORKTRUNK_TEST_BASH_INSTALLED: "0"
+ WORKTRUNK_TEST_CLAUDE_INSTALLED: "0"
+ WORKTRUNK_TEST_CODEX_INSTALLED: "0"
+ WORKTRUNK_TEST_DELAYED_STREAM_MS: "-1"
+ WORKTRUNK_TEST_EPOCH: "1735776000"
+ WORKTRUNK_TEST_FISH_INSTALLED: "0"
+ WORKTRUNK_TEST_GEMINI_INSTALLED: "0"
+ WORKTRUNK_TEST_MOCK_CONFIG_DIR: "[TEST_MOCK_CONFIG]"
+ WORKTRUNK_TEST_NUSHELL_ENV: "0"
+ WORKTRUNK_TEST_OPENCODE_INSTALLED: "0"
+ WORKTRUNK_TEST_PARENT_SHELL: ""
+ WORKTRUNK_TEST_POWERSHELL_ENV: "0"
+ WORKTRUNK_TEST_POWERSHELL_INSTALLED: "0"
+ WORKTRUNK_TEST_PROBE_TIMEOUT_MS: "60000"
+ WORKTRUNK_TEST_SKIP_URL_HEALTH_CHECK: "1"
+ WORKTRUNK_TEST_ZSH_INSTALLED: "0"
+ XDG_CONFIG_HOME: "[TEST_CONFIG_HOME]"
+---
+success: true
+exit_code: 0
+----- stdout -----
+○ Alias deploy (user):
+  echo hi
+
+----- stderr -----
diff --git a/tests/snapshots/integration__integration_tests__step_alias__alias_show_deprecated_named.snap b/tests/snapshots/integration__integration_tests__step_alias__alias_show_deprecated_named.snap
new file mode 100644
index 000000000..3c5092205
--- /dev/null
+++ b/tests/snapshots/integration__integration_tests__step_alias__alias_show_deprecated_named.snap
@@ -0,0 +1,65 @@
+---
+source: tests/integration_tests/step_alias.rs
+info:
+ program: wt
+ args:
+ - config
+ - alias
+ - show
+ - deploy
+ env:
+ APPDATA: "[TEST_CONFIG_HOME]"
+ CLAUDE_CONFIG_DIR: "[TEST_CLAUDE_CONFIG]"
+ CLICOLOR_FORCE: "1"
+ COLUMNS: "500"
+ GIT_ALLOW_PROTOCOL: file
+ GIT_AUTHOR_DATE: "2025-01-01T00:00:00Z"
+ GIT_AUTHOR_EMAIL: [email protected]
+ GIT_AUTHOR_NAME: Test User
+ GIT_COMMITTER_DATE: "2025-01-01T00:00:00Z"
+ GIT_COMMITTER_EMAIL: [email protected]
+ GIT_COMMITTER_NAME: Test User
+ GIT_CONFIG_COUNT: "2"
+ GIT_CONFIG_GLOBAL: /nonexistent/wt/gitconfig
+ GIT_CONFIG_KEY_0: user.useConfigOnly
+ GIT_CONFIG_KEY_1: rerere.enabled
+ GIT_CONFIG_SYSTEM: /nonexistent/wt/gitconfig
+ GIT_CONFIG_VALUE_0: "true"
+ GIT_CONFIG_VALUE_1: "false"
+ GIT_TERMINAL_PROMPT: "0"
+ HOME: "[TEST_HOME]"
+ LANG: C
+ LC_ALL: C
+ LLVM_PROFILE_FILE: "[LLVM_PROFILE_FILE]"
+ OPENCODE_CONFIG_DIR: "[TEST_OPENCODE_CONFIG]"
+ PATH: "[PATH]"
+ TERM: alacritty
+ USERPROFILE: "[TEST_HOME]"
+ WORKTRUNK_APPROVALS_PATH: "[TEST_APPROVALS]"
+ WORKTRUNK_CONFIG_PATH: "[TEST_CONFIG]"
+ WORKTRUNK_SYSTEM_CONFIG_PATH: "[TEST_SYSTEM_CONFIG]"
+ WORKTRUNK_TEST_BASH_INSTALLED: "0"
+ WORKTRUNK_TEST_CLAUDE_INSTALLED: "0"
+ WORKTRUNK_TEST_CODEX_INSTALLED: "0"
+ WORKTRUNK_TEST_DELAYED_STREAM_MS: "-1"
+ WORKTRUNK_TEST_EPOCH: "1735776000"
+ WORKTRUNK_TEST_FISH_INSTALLED: "0"
+ WORKTRUNK_TEST_GEMINI_INSTALLED: "0"
+ WORKTRUNK_TEST_MOCK_CONFIG_DIR: "[TEST_MOCK_CONFIG]"
+ WORKTRUNK_TEST_NUSHELL_ENV: "0"
+ WORKTRUNK_TEST_OPENCODE_INSTALLED: "0"
+ WORKTRUNK_TEST_PARENT_SHELL: ""
+ WORKTRUNK_TEST_POWERSHELL_ENV: "0"
+ WORKTRUNK_TEST_POWERSHELL_INSTALLED: "0"
+ WORKTRUNK_TEST_PROBE_TIMEOUT_MS: "60000"
+ WORKTRUNK_TEST_SKIP_URL_HEALTH_CHECK: "1"
+ WORKTRUNK_TEST_ZSH_INSTALLED: "0"
+ XDG_CONFIG_HOME: "[TEST_CONFIG_HOME]"
+---
+success: true
+exit_code: 0
+----- stdout -----
+○ Alias deploy (user):
+  echo hi
+
+----- stderr -----
diff --git a/tests/snapshots/integration__integration_tests__step_alias__alias_show_outside_all.snap b/tests/snapshots/integration__integration_tests__step_alias__alias_show_outside_all.snap
new file mode 100644
index 000000000..95d207f71
--- /dev/null
+++ b/tests/snapshots/integration__integration_tests__step_alias__alias_show_outside_all.snap
@@ -0,0 +1,64 @@
+---
+source: tests/integration_tests/step_alias.rs
+info:
+ program: wt
+ args:
+ - config
+ - alias
+ - show
+ env:
+ APPDATA: "[TEST_CONFIG_HOME]"
+ CLAUDE_CONFIG_DIR: "[TEST_CLAUDE_CONFIG]"
+ CLICOLOR_FORCE: "1"
+ COLUMNS: "500"
+ GIT_ALLOW_PROTOCOL: file
+ GIT_AUTHOR_DATE: "2025-01-01T00:00:00Z"
+ GIT_AUTHOR_EMAIL: [email protected]
+ GIT_AUTHOR_NAME: Test User
+ GIT_COMMITTER_DATE: "2025-01-01T00:00:00Z"
+ GIT_COMMITTER_EMAIL: [email protected]
+ GIT_COMMITTER_NAME: Test User
+ GIT_CONFIG_COUNT: "2"
+ GIT_CONFIG_GLOBAL: /nonexistent/wt/gitconfig
+ GIT_CONFIG_KEY_0: user.useConfigOnly
+ GIT_CONFIG_KEY_1: rerere.enabled
+ GIT_CONFIG_SYSTEM: /nonexistent/wt/gitconfig
+ GIT_CONFIG_VALUE_0: "true"
+ GIT_CONFIG_VALUE_1: "false"
+ GIT_TERMINAL_PROMPT: "0"
+ HOME: "[TEST_HOME]"
+ LANG: C
+ LC_ALL: C
+ LLVM_PROFILE_FILE: "[LLVM_PROFILE_FILE]"
+ OPENCODE_CONFIG_DIR: "[TEST_OPENCODE_CONFIG]"
+ PATH: "[PATH]"
+ TERM: alacritty
+ USERPROFILE: "[TEST_HOME]"
+ WORKTRUNK_APPROVALS_PATH: "[TEST_APPROVALS]"
+ WORKTRUNK_CONFIG_PATH: "[TEST_CONFIG]"
+ WORKTRUNK_SYSTEM_CONFIG_PATH: "[TEST_SYSTEM_CONFIG]"
+ WORKTRUNK_TEST_BASH_INSTALLED: "0"
+ WORKTRUNK_TEST_CLAUDE_INSTALLED: "0"
+ WORKTRUNK_TEST_CODEX_INSTALLED: "0"
+ WORKTRUNK_TEST_DELAYED_STREAM_MS: "-1"
+ WORKTRUNK_TEST_EPOCH: "1735776000"
+ WORKTRUNK_TEST_FISH_INSTALLED: "0"
+ WORKTRUNK_TEST_GEMINI_INSTALLED: "0"
+ WORKTRUNK_TEST_MOCK_CONFIG_DIR: "[TEST_MOCK_CONFIG]"
+ WORKTRUNK_TEST_NUSHELL_ENV: "0"
+ WORKTRUNK_TEST_OPENCODE_INSTALLED: "0"
+ WORKTRUNK_TEST_PARENT_SHELL: ""
+ WORKTRUNK_TEST_POWERSHELL_ENV: "0"
+ WORKTRUNK_TEST_POWERSHELL_INSTALLED: "0"
+ WORKTRUNK_TEST_PROBE_TIMEOUT_MS: "60000"
+ WORKTRUNK_TEST_SKIP_URL_HEALTH_CHECK: "1"
+ WORKTRUNK_TEST_ZSH_INSTALLED: "0"
+ XDG_CONFIG_HOME: "[TEST_CONFIG_HOME]"
+---
+success: true
+exit_code: 0
+----- stdout -----
+○ Alias deploy (user):
+  echo {{ branch }}
+
+----- stderr -----
diff --git a/tests/snapshots/integration__integration_tests__step_alias__alias_show_outside_named.snap b/tests/snapshots/integration__integration_tests__step_alias__alias_show_outside_named.snap
new file mode 100644
index 000000000..626ce9da9
--- /dev/null
+++ b/tests/snapshots/integration__integration_tests__step_alias__alias_show_outside_named.snap
@@ -0,0 +1,65 @@
+---
+source: tests/integration_tests/step_alias.rs
+info:
+ program: wt
+ args:
+ - config
+ - alias
+ - show
+ - deploy
+ env:
+ APPDATA: "[TEST_CONFIG_HOME]"
+ CLAUDE_CONFIG_DIR: "[TEST_CLAUDE_CONFIG]"
+ CLICOLOR_FORCE: "1"
+ COLUMNS: "500"
+ GIT_ALLOW_PROTOCOL: file
+ GIT_AUTHOR_DATE: "2025-01-01T00:00:00Z"
+ GIT_AUTHOR_EMAIL: [email protected]
+ GIT_AUTHOR_NAME: Test User
+ GIT_COMMITTER_DATE: "2025-01-01T00:00:00Z"
+ GIT_COMMITTER_EMAIL: [email protected]
+ GIT_COMMITTER_NAME: Test User
+ GIT_CONFIG_COUNT: "2"
+ GIT_CONFIG_GLOBAL: /nonexistent/wt/gitconfig
+ GIT_CONFIG_KEY_0: user.useConfigOnly
+ GIT_CONFIG_KEY_1: rerere.enabled
+ GIT_CONFIG_SYSTEM: /nonexistent/wt/gitconfig
+ GIT_CONFIG_VALUE_0: "true"
+ GIT_CONFIG_VALUE_1: "false"
+ GIT_TERMINAL_PROMPT: "0"
+ HOME: "[TEST_HOME]"
+ LANG: C
+ LC_ALL: C
+ LLVM_PROFILE_FILE: "[LLVM_PROFILE_FILE]"
+ OPENCODE_CONFIG_DIR: "[TEST_OPENCODE_CONFIG]"
+ PATH: "[PATH]"
+ TERM: alacritty
+ USERPROFILE: "[TEST_HOME]"
+ WORKTRUNK_APPROVALS_PATH: "[TEST_APPROVALS]"
+ WORKTRUNK_CONFIG_PATH: "[TEST_CONFIG]"
+ WORKTRUNK_SYSTEM_CONFIG_PATH: "[TEST_SYSTEM_CONFIG]"
+ WORKTRUNK_TEST_BASH_INSTALLED: "0"
+ WORKTRUNK_TEST_CLAUDE_INSTALLED: "0"
+ WORKTRUNK_TEST_CODEX_INSTALLED: "0"
+ WORKTRUNK_TEST_DELAYED_STREAM_MS: "-1"
+ WORKTRUNK_TEST_EPOCH: "1735776000"
+ WORKTRUNK_TEST_FISH_INSTALLED: "0"
+ WORKTRUNK_TEST_GEMINI_INSTALLED: "0"
+ WORKTRUNK_TEST_MOCK_CONFIG_DIR: "[TEST_MOCK_CONFIG]"
+ WORKTRUNK_TEST_NUSHELL_ENV: "0"
+ WORKTRUNK_TEST_OPENCODE_INSTALLED: "0"
+ WORKTRUNK_TEST_PARENT_SHELL: ""
+ WORKTRUNK_TEST_POWERSHELL_ENV: "0"
+ WORKTRUNK_TEST_POWERSHELL_INSTALLED: "0"
+ WORKTRUNK_TEST_PROBE_TIMEOUT_MS: "60000"
+ WORKTRUNK_TEST_SKIP_URL_HEALTH_CHECK: "1"
+ WORKTRUNK_TEST_ZSH_INSTALLED: "0"
+ XDG_CONFIG_HOME: "[TEST_CONFIG_HOME]"
+---
+success: true
+exit_code: 0
+----- stdout -----
+○ Alias deploy (user):
+  echo {{ branch }}
+
+----- stderr -----
diff --git a/tests/snapshots/integration__integration_tests__step_alias__alias_show_outside_typo.snap b/tests/snapshots/integration__integration_tests__step_alias__alias_show_outside_typo.snap
new file mode 100644
index 000000000..2a6df404e
--- /dev/null
+++ b/tests/snapshots/integration__integration_tests__step_alias__alias_show_outside_typo.snap
@@ -0,0 +1,70 @@
+---
+source: tests/integration_tests/step_alias.rs
+info:
+ program: wt
+ args:
+ - config
+ - alias
+ - show
+ - deplyo
+ env:
+ APPDATA: "[TEST_CONFIG_HOME]"
+ CLAUDE_CONFIG_DIR: "[TEST_CLAUDE_CONFIG]"
+ CLICOLOR_FORCE: "1"
+ COLUMNS: "500"
+ GIT_ALLOW_PROTOCOL: file
+ GIT_AUTHOR_DATE: "2025-01-01T00:00:00Z"
+ GIT_AUTHOR_EMAIL: [email protected]
+ GIT_AUTHOR_NAME: Test User
+ GIT_COMMITTER_DATE: "2025-01-01T00:00:00Z"
+ GIT_COMMITTER_EMAIL: [email protected]
+ GIT_COMMITTER_NAME: Test User
+ GIT_CONFIG_COUNT: "2"
+ GIT_CONFIG_GLOBAL: /nonexistent/wt/gitconfig
+ GIT_CONFIG_KEY_0: user.useConfigOnly
+ GIT_CONFIG_KEY_1: rerere.enabled
+ GIT_CONFIG_SYSTEM: /nonexistent/wt/gitconfig
+ GIT_CONFIG_VALUE_0: "true"
+ GIT_CONFIG_VALUE_1: "false"
+ GIT_TERMINAL_PROMPT: "0"
+ HOME: "[TEST_HOME]"
+ LANG: C
+ LC_ALL: C
+ LLVM_PROFILE_FILE: "[LLVM_PROFILE_FILE]"
+ OPENCODE_CONFIG_DIR: "[TEST_OPENCODE_CONFIG]"
+ PATH: "[PATH]"
+ TERM: alacritty
+ USERPROFILE: "[TEST_HOME]"
+ WORKTRUNK_APPROVALS_PATH: "[TEST_APPROVALS]"
+ WORKTRUNK_CONFIG_PATH: "[TEST_CONFIG]"
+ WORKTRUNK_SYSTEM_CONFIG_PATH: "[TEST_SYSTEM_CONFIG]"
+ WORKTRUNK_TEST_BASH_INSTALLED: "0"
+ WORKTRUNK_TEST_CLAUDE_INSTALLED: "0"
+ WORKTRUNK_TEST_CODEX_INSTALLED: "0"
+ WORKTRUNK_TEST_DELAYED_STREAM_MS: "-1"
+ WORKTRUNK_TEST_EPOCH: "1735776000"
+ WORKTRUNK_TEST_FISH_INSTALLED: "0"
+ WORKTRUNK_TEST_GEMINI_INSTALLED: "0"
+ WORKTRUNK_TEST_MOCK_CONFIG_DIR: "[TEST_MOCK_CONFIG]"
+ WORKTRUNK_TEST_NUSHELL_ENV: "0"
+ WORKTRUNK_TEST_OPENCODE_INSTALLED: "0"
+ WORKTRUNK_TEST_PARENT_SHELL: ""
+ WORKTRUNK_TEST_POWERSHELL_ENV: "0"
+ WORKTRUNK_TEST_POWERSHELL_INSTALLED: "0"
+ WORKTRUNK_TEST_PROBE_TIMEOUT_MS: "60000"
+ WORKTRUNK_TEST_SKIP_URL_HEALTH_CHECK: "1"
+ WORKTRUNK_TEST_ZSH_INSTALLED: "0"
+ XDG_CONFIG_HOME: "[TEST_CONFIG_HOME]"
+---
+success: false
+exit_code: 2
+----- stdout -----
+
+----- stderr -----
+error: unrecognized alias 'deplyo'
+
+ tip: a similar alias exists: 'deploy'
+
+Usage: wt config alias show [NAME]
+
+For more information, try '--help'.