Skip to content

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

refactor(cli): split cli.rs into module structure (#471)

Maximilian Roos230ab37591b0
diff --git a/src/cli/config.rs b/src/cli/config.rs
new file mode 100644
index 000000000..df4756c9a
--- /dev/null
+++ b/src/cli/config.rs
@@ -0,0 +1,748 @@
+use clap::Subcommand;
+
+use crate::commands::Shell;
+
+#[derive(Subcommand)]
+pub enum ConfigShellCommand {
+ /// Generate shell integration code
+ #[command(after_long_help = r#"## Manual Setup
+
+Add one line to the shell config:
+
+Bash (~/.bashrc):
+```console
+eval "$(wt config shell init bash)"
+```
+
+Fish (~/.config/fish/config.fish):
+```fish
+wt config shell init fish | source
+```
+
+Zsh (~/.zshrc):
+```zsh
+eval "$(wt config shell init zsh)"
+```
+
+## Auto setup
+
+Use `wt config shell install` to add to the shell config automatically."#)]
+ Init {
+ /// Shell to generate code for
+ #[arg(value_enum)]
+ shell: Shell,
+
+ /// Command name for shell integration (defaults to binary name)
+ ///
+ /// Use this to create shell integration for an alternate command name.
+ /// For example, `--cmd=git-wt` creates a `git-wt` shell function
+ /// instead of `wt`, useful on Windows where `wt` conflicts with Windows Terminal.
+ #[arg(long)]
+ cmd: Option<String>,
+ },
+
+ /// Write shell integration to config files
+ #[command(after_long_help = r#"## Auto setup
+
+Detects existing shell config files and adds integration:
+```console
+wt config shell install
+```
+
+Install for specific shell only:
+```console
+wt config shell install zsh
+```
+
+Shows proposed changes and waits for confirmation before modifying any files.
+Use --yes to skip confirmation."#)]
+ Install {
+ /// Shell to install (default: all)
+ #[arg(value_enum)]
+ shell: Option<Shell>,
+
+ /// Skip confirmation prompt
+ #[arg(short, long)]
+ yes: bool,
+
+ /// Command name for shell integration (defaults to binary name)
+ ///
+ /// Use this to create shell integration for an alternate command name.
+ /// For example, `--cmd=git-wt` creates a `git-wt` shell function
+ /// instead of `wt`, useful on Windows where `wt` conflicts with Windows Terminal.
+ #[arg(long)]
+ cmd: Option<String>,
+ },
+
+ /// Remove shell integration from config files
+ #[command(after_long_help = r#"## Removal
+
+Removes shell integration lines from config files:
+```console
+wt config shell uninstall
+```
+
+Remove from specific shell only:
+```console
+wt config shell uninstall zsh
+```
+
+Skip confirmation prompt:
+```console
+wt config shell uninstall --yes
+```
+
+## Version tolerance
+
+Detects various forms of the integration pattern regardless of:
+- Command prefix (wt, worktree, etc.)
+- Minor syntax variations between versions"#)]
+ Uninstall {
+ /// Shell to uninstall (default: all)
+ #[arg(value_enum)]
+ shell: Option<Shell>,
+
+ /// Skip confirmation prompt
+ #[arg(short, long)]
+ yes: bool,
+ },
+
+ /// Show output theme samples
+ #[command(after_long_help = r#"## Output Theme
+
+Displays samples of all output message types:
+- Progress, success, error, warning, hint, info
+- Gutter formatting for quoted content
+- Prompts for user input
+
+Use this to preview how worktrunk output will appear in the terminal."#)]
+ ShowTheme,
+}
+
+#[derive(Subcommand)]
+pub enum ApprovalsCommand {
+ /// Store approvals in config
+ #[command(
+ after_long_help = r#"Prompts for approval of all project commands and saves them to user config.
+
+By default, shows only unapproved commands. Use `--all` to review all commands
+including previously approved ones."#
+ )]
+ Add {
+ /// Show all commands
+ #[arg(long)]
+ all: bool,
+ },
+
+ /// Clear approved commands from config
+ #[command(
+ after_long_help = r#"Removes saved approvals, requiring re-approval on next command run.
+
+By default, clears approvals for the current project. Use `--global` to clear
+all approvals across all projects."#
+ )]
+ Clear {
+ /// Clear global approvals
+ #[arg(short, long)]
+ global: bool,
+ },
+}
+
+#[derive(Subcommand)]
+pub enum ConfigCommand {
+ /// Shell integration setup
+ Shell {
+ #[command(subcommand)]
+ action: ConfigShellCommand,
+ },
+
+ /// Create configuration file
+ #[command(
+ after_long_help = concat!(
+ "## User config\n\n",
+ "Creates `~/.config/worktrunk/config.toml` with the following content:\n\n```\n",
+ include_str!("../../dev/config.example.toml"),
+ "```\n\n",
+ "## Project config\n\n",
+ "With `--project`, creates `.config/wt.toml` in the current repository:\n\n```\n",
+ include_str!("../../dev/wt.example.toml"),
+ "```"
+ )
+ )]
+ Create {
+ /// Create project config (`.config/wt.toml`) instead of user config
+ #[arg(long)]
+ project: bool,
+ },
+
+ /// Show configuration files & locations
+ #[command(
+ after_long_help = r#"Shows location and contents of user config (`~/.config/worktrunk/config.toml`)
+and project config (`.config/wt.toml`).
+
+If a config file doesn't exist, shows defaults that would be used.
+
+## Full diagnostics
+
+Use `--full` to run diagnostic checks:
+
+```console
+wt config show --full
+```
+
+This tests:
+- **CI tool status** — Whether `gh` (GitHub) or `glab` (GitLab) is installed and authenticated
+- **Commit generation** — Whether the LLM command can generate commit messages"#
+ )]
+ Show {
+ /// Run diagnostic checks (CI tools, commit generation)
+ #[arg(long)]
+ full: bool,
+ },
+
+ /// Manage internal data and cache
+ #[command(
+ after_long_help = r#"State is stored in `.git/` (config entries and log files), separate from configuration files.
+Use `wt config show` to view file-based configuration.
+
+## Keys
+
+- **default-branch**: The repository's default branch (main, master, etc.)
+- **previous-branch**: Previous branch for `wt switch -`
+- **ci-status**: CI/PR status for a branch (passed, running, failed, conflicts, no-ci, error)
+- **marker**: Custom status marker for a branch (shown in `wt list`)
+- **logs**: Background operation logs
+
+## Examples
+
+Get the default branch:
+```console
+wt config state default-branch
+```
+
+Set the default branch manually:
+```console
+wt config state default-branch set main
+```
+
+Set a marker for current branch:
+```console
+wt config state marker set "🚧 WIP"
+```
+
+Clear all CI status cache:
+```console
+wt config state ci-status clear --all
+```
+
+Show all stored state:
+```console
+wt config state get
+```
+
+Clear all stored state:
+```console
+wt config state clear
+```
+
+<!-- subdoc: default-branch -->
+
+<!-- subdoc: ci-status -->
+
+<!-- subdoc: marker -->
+
+<!-- subdoc: logs -->"#
+ )]
+ State {
+ #[command(subcommand)]
+ action: StateCommand,
+ },
+}
+
+#[derive(Subcommand)]
+pub enum StateCommand {
+ /// Default branch setting
+ #[command(
+ name = "default-branch",
+ after_long_help = r#"## Detection
+
+Worktrunk detects the default branch automatically:
+
+1. **Worktrunk cache** — Checks `git config worktrunk.default-branch` (single command)
+2. **Git cache** — Detects primary remote and checks its HEAD (e.g., `origin/HEAD`)
+3. **Remote query** — If not cached, queries `git ls-remote` (100ms–2s)
+4. **Local inference** — If no remote, infers from local branches
+
+Once detected, the result is cached in `worktrunk.default-branch` for fast access.
+
+The local inference fallback uses these heuristics in order:
+- If only one local branch exists, uses it
+- For bare repos or empty repos, checks `symbolic-ref HEAD`
+- Checks `git config init.defaultBranch`
+- Looks for common names: main, master, develop, trunk
+
+## When to use
+
+Most users never need this command — default branch detection is automatic.
+Use it to:
+
+- **Debug** — See what worktrunk thinks the default branch is
+- **Override** — Set a non-standard default branch with `set`
+- **Refresh** — Force re-query with `get --refresh` after remote changes
+- **Clear** — Remove cached value with `clear`
+
+Without a subcommand, runs `get`. For `--refresh`, use `get --refresh`."#
+ )]
+ DefaultBranch {
+ #[command(subcommand)]
+ action: Option<DefaultBranchAction>,
+ },
+
+ /// Previous branch (for `wt switch -`)
+ #[command(
+ name = "previous-branch",
+ after_long_help = r#"Enables `wt switch -` to return to the previous worktree, similar to `cd -` or `git checkout -`.
+
+## How it works
+
+Updated automatically on every `wt switch`. Stored in git config as `worktrunk.history`.
+
+## When to use
+
+Most users never need this command — the previous branch updates automatically.
+Use it to:
+
+- **Debug** — See what `-` resolves to
+- **Override** — Set a specific branch as "previous"
+- **Clear** — Reset the history
+
+Without a subcommand, runs `get`."#
+ )]
+ PreviousBranch {
+ #[command(subcommand)]
+ action: Option<PreviousBranchAction>,
+ },
+
+ /// CI status cache
+ #[command(
+ name = "ci-status",
+ after_long_help = r#"Caches GitHub/GitLab CI status for display in [`wt list`](@/list.md#ci-status).
+
+## How it works
+
+1. **Platform detection** — From `[ci] platform` in project config, or detected from remote URL (github.com → GitHub, gitlab.com → GitLab)
+2. **CLI requirement** — Requires `gh` (GitHub) or `glab` (GitLab) CLI, authenticated
+3. **What's checked** — PRs/MRs first, then branch pipelines for branches with upstream
+4. **Caching** — Results cached 30-60 seconds per branch+commit
+
+## Status values
+
+| Status | Meaning |
+|--------|---------|
+| `passed` | All checks passed |
+| `running` | Checks in progress |
+| `failed` | Checks failed |
+| `conflicts` | PR has merge conflicts |
+| `no-ci` | No checks configured |
+| `error` | Fetch error (rate limit, network, auth) |
+
+See [`wt list` CI status](@/list.md#ci-status) for display symbols and colors.
+
+## When to use
+
+- **Debug** — See cached status and when it was fetched
+- **Refresh** — Force re-fetch with `get --refresh`
+- **Clear** — Remove stale cache entries
+
+Without a subcommand, runs `get` for the current branch. For `--branch` or `--refresh`, use `get --branch=NAME`."#
+ )]
+ CiStatus {
+ #[command(subcommand)]
+ action: Option<CiStatusAction>,
+ },
+
+ /// Branch markers
+ #[command(
+ after_long_help = r#"Custom status text or emoji shown in the `wt list` Status column.
+
+## Display
+
+Markers appear at the start of the Status column:
+
+```
+Branch Status Path
+main ^ ~/code/myproject
+feature 🚧↑ ~/code/myproject.feature
+bugfix 🤖!↑⇡ ~/code/myproject.bugfix
+```
+
+## Use cases
+
+- **Work status** — `🚧` WIP, `✅` ready for review, `🔥` urgent
+- **Agent tracking** — The [Claude Code plugin](@/claude-code.md) sets markers automatically
+- **Notes** — Any short text: `"blocked"`, `"needs tests"`
+
+## Storage
+
+Stored in git config as `worktrunk.state.<branch>.marker`. Set directly with:
+
+```console
+git config worktrunk.state.feature.marker '{"marker":"🚧","set_at":0}'
+```
+
+Without a subcommand, runs `get` for the current branch. For `--branch`, use `get --branch=NAME`."#
+ )]
+ Marker {
+ #[command(subcommand)]
+ action: Option<MarkerAction>,
+ },
+
+ /// Background operation logs
+ #[command(after_long_help = r#"View and manage logs from background operations.
+
+## What's logged
+
+| Operation | Log file |
+|-----------|----------|
+| post-start hooks | `{branch}-{source}-post-start-{name}.log` |
+| Background removal | `{branch}-remove.log` |
+
+Source is `user` or `project` depending on where the hook is defined.
+
+## Location
+
+All logs are stored in `.git/wt-logs/` (in the main worktree's git directory).
+
+## Behavior
+
+- **Overwrites** — Same operation on same branch overwrites previous log
+- **Persists** — Logs from deleted branches remain until manually cleared
+- **Shared** — All worktrees write to the same log directory
+
+## Examples
+
+List all log files:
+```console
+wt config state logs get
+```
+
+View a specific log:
+```console
+cat "$(git rev-parse --git-dir)/wt-logs/feature-project-post-start-build.log"
+```
+
+Clear all logs:
+```console
+wt config state logs clear
+```"#)]
+ Logs {
+ #[command(subcommand)]
+ action: Option<LogsAction>,
+ },
+
+ /// One-time hints shown in this repo
+ #[command(
+ after_long_help = r#"Some hints show once per repo on first use, then are recorded in git config
+as `worktrunk.hints.<name> = true`.
+
+## Current hints
+
+| Name | Trigger | Message |
+|------|---------|---------|
+| `worktree-path` | First `wt switch --create` | Customize worktree locations: wt config create |
+
+## Examples
+
+```console
+wt config state hints # list shown hints
+wt config state hints clear # re-show all hints
+wt config state hints clear NAME # re-show specific hint
+```"#
+ )]
+ Hints {
+ #[command(subcommand)]
+ action: Option<HintsAction>,
+ },
+
+ /// Get all stored state
+ #[command(after_long_help = r#"Shows all stored state including:
+
+- **Default branch**: Cached result of querying remote for default branch
+- **Previous branch**: Previous branch for `wt switch -`
+- **Branch markers**: User-defined branch notes
+- **CI status**: Cached GitHub/GitLab CI status per branch (30s TTL)
+- **Hints**: One-time hints that have been shown
+- **Log files**: Background operation logs
+
+CI cache entries show status, age, and the commit SHA they were fetched for."#)]
+ Get {
+ /// Output format (table, json)
+ #[arg(long, value_enum, default_value = "table", hide_possible_values = true)]
+ format: super::OutputFormat,
+ },
+
+ /// Clear all stored state
+ #[command(after_long_help = r#"Clears all stored state:
+
+- Default branch cache
+- Previous branch
+- All branch markers
+- All CI status cache
+- All hints
+- All log files
+
+Use individual subcommands (`default-branch clear`, `ci-status clear --all`, etc.)
+to clear specific state."#)]
+ Clear,
+}
+
+#[derive(Subcommand)]
+pub enum DefaultBranchAction {
+ /// Get the default branch
+ #[command(after_long_help = r#"## Examples
+
+Get the default branch:
+```console
+wt config state default-branch
+```
+
+Force refresh from remote:
+```console
+wt config state default-branch get --refresh
+```"#)]
+ Get {
+ /// Force refresh from remote
+ #[arg(long)]
+ refresh: bool,
+ },
+
+ /// Set the default branch
+ #[command(after_long_help = r#"## Examples
+
+Set the default branch:
+```console
+wt config state default-branch set main
+```"#)]
+ Set {
+ /// Branch name to set as default
+ #[arg(add = crate::completion::branch_value_completer())]
+ branch: String,
+ },
+
+ /// Clear the default branch cache
+ Clear,
+}
+
+#[derive(Subcommand)]
+pub enum PreviousBranchAction {
+ /// Get the previous branch
+ #[command(after_long_help = r#"## Examples
+
+Get the previous branch (used by `wt switch -`):
+```console
+wt config state previous-branch
+```"#)]
+ Get,
+
+ /// Set the previous branch
+ #[command(after_long_help = r#"## Examples
+
+Set the previous branch:
+```console
+wt config state previous-branch set feature
+```"#)]
+ Set {
+ /// Branch name to set as previous
+ #[arg(add = crate::completion::branch_value_completer())]
+ branch: String,
+ },
+
+ /// Clear the previous branch
+ Clear,
+}
+
+#[derive(Subcommand)]
+pub enum CiStatusAction {
+ /// Get CI status for a branch
+ #[command(
+ after_long_help = r#"Returns: passed, running, failed, conflicts, no-ci, or error.
+
+## Examples
+
+Get CI status for current branch:
+```console
+wt config state ci-status
+```
+
+Force refresh from GitHub/GitLab:
+```console
+wt config state ci-status get --refresh
+```
+
+Get CI status for a specific branch:
+```console
+wt config state ci-status get --branch=feature
+```"#
+ )]
+ Get {
+ /// Force refresh from GitHub/GitLab
+ #[arg(long)]
+ refresh: bool,
+
+ /// Target branch (defaults to current)
+ #[arg(long, add = crate::completion::branch_value_completer())]
+ branch: Option<String>,
+ },
+
+ /// Clear CI status cache
+ #[command(after_long_help = r#"## Examples
+
+Clear CI status for current branch:
+```console
+wt config state ci-status clear
+```
+
+Clear CI status for a specific branch:
+```console
+wt config state ci-status clear --branch=feature
+```
+
+Clear all CI status cache:
+```console
+wt config state ci-status clear --all
+```"#)]
+ Clear {
+ /// Target branch (defaults to current)
+ #[arg(long, add = crate::completion::branch_value_completer(), conflicts_with = "all")]
+ branch: Option<String>,
+
+ /// Clear all CI status cache
+ #[arg(long)]
+ all: bool,
+ },
+}
+
+#[derive(Subcommand)]
+pub enum MarkerAction {
+ /// Get marker for a branch
+ #[command(after_long_help = r#"## Examples
+
+Get marker for current branch:
+```console
+wt config state marker
+```
+
+Get marker for a specific branch:
+```console
+wt config state marker get --branch=feature
+```"#)]
+ Get {
+ /// Target branch (defaults to current)
+ #[arg(long, add = crate::completion::branch_value_completer())]
+ branch: Option<String>,
+ },
+
+ /// Set marker for a branch
+ #[command(after_long_help = r#"## Examples
+
+Set marker for current branch:
+```console
+wt config state marker set "🚧 WIP"
+```
+
+Set marker for a specific branch:
+```console
+wt config state marker set "✅ ready" --branch=feature
+```"#)]
+ Set {
+ /// Marker text (shown in `wt list` output)
+ value: String,
+
+ /// Target branch (defaults to current)
+ #[arg(long, add = crate::completion::branch_value_completer())]
+ branch: Option<String>,
+ },
+
+ /// Clear marker for a branch
+ #[command(after_long_help = r#"## Examples
+
+Clear marker for current branch:
+```console
+wt config state marker clear
+```
+
+Clear marker for a specific branch:
+```console
+wt config state marker clear --branch=feature
+```
+
+Clear all markers:
+```console
+wt config state marker clear --all
+```"#)]
+ Clear {
+ /// Target branch (defaults to current)
+ #[arg(long, add = crate::completion::branch_value_completer(), conflicts_with = "all")]
+ branch: Option<String>,
+
+ /// Clear all markers
+ #[arg(long)]
+ all: bool,
+ },
+}
+
+#[derive(Subcommand)]
+pub enum LogsAction {
+ /// List background operation log files
+ #[command(
+ after_long_help = r#"Lists log files from background operations like post-start commands and worktree removal.
+
+## Examples
+
+List log files:
+```console
+wt config state logs
+```"#
+ )]
+ Get,
+
+ /// Clear background operation logs
+ Clear,
+}
+
+#[derive(Subcommand)]
+pub enum HintsAction {
+ /// List hints that have been shown
+ #[command(
+ after_long_help = r#"Lists which one-time hints have been shown in this repository.
+
+## Examples
+
+List shown hints:
+```console
+wt config state hints
+```"#
+ )]
+ Get,
+
+ /// Clear hints (re-show on next trigger)
+ #[command(
+ after_long_help = r#"Clears hint state so hints will show again on next trigger.
+
+## Examples
+
+Clear all hints:
+```console
+wt config state hints clear
+```
+
+Clear a specific hint:
+```console
+wt config state hints clear worktree-path
+```"#
+ )]
+ Clear {
+ /// Specific hint to clear (clears all if not specified)
+ name: Option<String>,
+ },
+}
diff --git a/src/cli/hook.rs b/src/cli/hook.rs
new file mode 100644
index 000000000..542f4f149
--- /dev/null
+++ b/src/cli/hook.rs
@@ -0,0 +1,208 @@
+use clap::Subcommand;
+
+use super::config::ApprovalsCommand;
+
+/// Run configured hooks
+#[derive(Subcommand)]
+pub enum HookCommand {
+ /// Show configured hooks
+ ///
+ /// Lists user and project hooks. Project hooks show approval status (❓ = needs approval).
+ Show {
+ /// Hook type to show (default: all)
+ #[arg(value_parser = ["post-create", "post-start", "post-switch", "pre-commit", "pre-merge", "post-merge", "pre-remove"])]
+ hook_type: Option<String>,
+
+ /// Show expanded commands with current variables
+ #[arg(long)]
+ expanded: bool,
+ },
+
+ /// Run post-create hooks
+ ///
+ /// Blocking — waits for completion before continuing.
+ PostCreate {
+ /// Filter by command name
+ ///
+ /// Supports `user:name` or `project:name` to filter by source.
+ /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
+ #[arg(add = crate::completion::hook_command_name_completer())]
+ name: Option<String>,
+
+ /// Skip approval prompts
+ #[arg(short, long)]
+ yes: bool,
+
+ /// Override built-in template variable (KEY=VALUE)
+ #[arg(long = "var", value_name = "KEY=VALUE", value_parser = super::parse_key_val, action = clap::ArgAction::Append)]
+ vars: Vec<(String, String)>,
+ },
+
+ /// Run post-start hooks
+ ///
+ /// Background by default. Use `--foreground` to run in foreground for debugging.
+ PostStart {
+ /// Filter by command name
+ ///
+ /// Supports `user:name` or `project:name` to filter by source.
+ /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
+ #[arg(add = crate::completion::hook_command_name_completer())]
+ name: Option<String>,
+
+ /// Skip approval prompts
+ #[arg(short, long)]
+ yes: bool,
+
+ /// Run in foreground (block until complete)
+ #[arg(long)]
+ foreground: bool,
+
+ /// Deprecated: use --foreground instead
+ #[arg(long = "no-background", hide = true)]
+ no_background: bool,
+
+ /// Override built-in template variable (KEY=VALUE)
+ #[arg(long = "var", value_name = "KEY=VALUE", value_parser = super::parse_key_val, action = clap::ArgAction::Append)]
+ vars: Vec<(String, String)>,
+ },
+
+ /// Run post-switch hooks
+ ///
+ /// Background by default. Use `--foreground` to run in foreground for debugging.
+ PostSwitch {
+ /// Filter by command name
+ ///
+ /// Supports `user:name` or `project:name` to filter by source.
+ /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
+ #[arg(add = crate::completion::hook_command_name_completer())]
+ name: Option<String>,
+
+ /// Skip approval prompts
+ #[arg(short, long)]
+ yes: bool,
+
+ /// Run in foreground (block until complete)
+ #[arg(long)]
+ foreground: bool,
+
+ /// Deprecated: use --foreground instead
+ #[arg(long = "no-background", hide = true)]
+ no_background: bool,
+
+ /// Override built-in template variable (KEY=VALUE)
+ #[arg(long = "var", value_name = "KEY=VALUE", value_parser = super::parse_key_val, action = clap::ArgAction::Append)]
+ vars: Vec<(String, String)>,
+ },
+
+ /// Run pre-commit hooks
+ PreCommit {
+ /// Filter by command name
+ ///
+ /// Supports `user:name` or `project:name` to filter by source.
+ /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
+ #[arg(add = crate::completion::hook_command_name_completer())]
+ name: Option<String>,
+
+ /// Skip approval prompts
+ #[arg(short, long)]
+ yes: bool,
+
+ /// Override built-in template variable (KEY=VALUE)
+ #[arg(long = "var", value_name = "KEY=VALUE", value_parser = super::parse_key_val, action = clap::ArgAction::Append)]
+ vars: Vec<(String, String)>,
+ },
+
+ /// Run pre-merge hooks
+ PreMerge {
+ /// Filter by command name
+ ///
+ /// Supports `user:name` or `project:name` to filter by source.
+ /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
+ #[arg(add = crate::completion::hook_command_name_completer())]
+ name: Option<String>,
+
+ /// Skip approval prompts
+ #[arg(short, long)]
+ yes: bool,
+
+ /// Override built-in template variable (KEY=VALUE)
+ #[arg(long = "var", value_name = "KEY=VALUE", value_parser = super::parse_key_val, action = clap::ArgAction::Append)]
+ vars: Vec<(String, String)>,
+ },
+
+ /// Run post-merge hooks
+ PostMerge {
+ /// Filter by command name
+ ///
+ /// Supports `user:name` or `project:name` to filter by source.
+ /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
+ #[arg(add = crate::completion::hook_command_name_completer())]
+ name: Option<String>,
+
+ /// Skip approval prompts
+ #[arg(short, long)]
+ yes: bool,
+
+ /// Override built-in template variable (KEY=VALUE)
+ #[arg(long = "var", value_name = "KEY=VALUE", value_parser = super::parse_key_val, action = clap::ArgAction::Append)]
+ vars: Vec<(String, String)>,
+ },
+
+ /// Run pre-remove hooks
+ PreRemove {
+ /// Filter by command name
+ ///
+ /// Supports `user:name` or `project:name` to filter by source.
+ /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
+ #[arg(add = crate::completion::hook_command_name_completer())]
+ name: Option<String>,
+
+ /// Skip approval prompts
+ #[arg(short, long)]
+ yes: bool,
+
+ /// Override built-in template variable (KEY=VALUE)
+ #[arg(long = "var", value_name = "KEY=VALUE", value_parser = super::parse_key_val, action = clap::ArgAction::Append)]
+ vars: Vec<(String, String)>,
+ },
+
+ /// Manage command approvals
+ #[command(after_long_help = r#"## How Approvals Work
+
+Commands from project hooks (`.config/wt.toml`) require approval on first run.
+This prevents untrusted projects from running arbitrary commands.
+
+**Approval flow:**
+1. Command is shown as a template (variables not expanded)
+2. User approves or denies
+3. Approved commands are saved to user config under `[projects."project-id"]`
+
+**When re-approval is required:**
+- Command template changes (not just variable values)
+- Project ID changes (repository moves)
+
+**Bypassing prompts:**
+- `--yes` flag on individual commands (e.g., `wt merge --yes`)
+- Useful for CI/automation where prompts aren't possible
+
+## Examples
+
+Pre-approve all commands for current project:
+```console
+wt hook approvals add
+```
+
+Clear approvals for current project:
+```console
+wt hook approvals clear
+```
+
+Clear global approvals:
+```console
+wt hook approvals clear --global
+```"#)]
+ Approvals {
+ #[command(subcommand)]
+ action: ApprovalsCommand,
+ },
+}
diff --git a/src/cli/list.rs b/src/cli/list.rs
new file mode 100644
index 000000000..b48c2d08b
--- /dev/null
+++ b/src/cli/list.rs
@@ -0,0 +1,18 @@
+use clap::Subcommand;
+
+/// Subcommands for `wt list`
+#[derive(Subcommand)]
+pub enum ListSubcommand {
+ /// Single-line status for shell prompts
+ ///
+ /// For shell prompts, starship, or editor integrations.
+ #[command(after_long_help = "Format: `branch status ±working commits upstream ci`")]
+ Statusline {
+ /// Claude Code mode: read context from stdin, add directory and model
+ ///
+ /// Reads JSON from stdin with `.workspace.current_dir` and `.model.display_name`.
+ /// Output: `dir branch status ±working commits upstream ci | model`
+ #[arg(long)]
+ claude_code: bool,
+ },
+}
diff --git a/src/cli.rs b/src/cli/mod.rs
similarity index 69%
rename from src/cli.rs
rename to src/cli/mod.rs
index af8f62222..0ffe3e8a9 100644
--- a/src/cli.rs
+++ b/src/cli/mod.rs
@@ -1,3 +1,14 @@
+mod config;
+mod hook;
+mod list;
+
+pub use config::{
+ ApprovalsCommand, CiStatusAction, ConfigCommand, ConfigShellCommand, DefaultBranchAction,
+ HintsAction, LogsAction, MarkerAction, PreviousBranchAction, StateCommand,
+};
+pub use hook::HookCommand;
+pub use list::ListSubcommand;
+
use clap::builder::styling::{AnsiColor, Color, Styles};
use clap::{Command, CommandFactory, Parser, Subcommand, ValueEnum};
use std::sync::OnceLock;
@@ -9,7 +20,7 @@ use crate::commands::Shell;
///
/// Used by the `--var` flag on hook commands to override built-in template variables.
/// Values are shell-escaped during template expansion (see `expand_template` in expansion.rs).
-fn parse_key_val(s: &str) -> Result<(String, String), String> {
+pub(super) fn parse_key_val(s: &str) -> Result<(String, String), String> {
let (key, value) = s
.split_once('=')
.ok_or_else(|| format!("invalid KEY=VALUE: no `=` found in `{s}`"))?;
@@ -207,751 +218,6 @@ pub struct Cli {
pub command: Option<Commands>,
}
-#[derive(Subcommand)]
-pub enum ConfigShellCommand {
- /// Generate shell integration code
- #[command(after_long_help = r#"## Manual Setup
-
-Add one line to the shell config:
-
-Bash (~/.bashrc):
-```console
-eval "$(wt config shell init bash)"
-```
-
-Fish (~/.config/fish/config.fish):
-```fish
-wt config shell init fish | source
-```
-
-Zsh (~/.zshrc):
-```zsh
-eval "$(wt config shell init zsh)"
-```
-
-## Auto setup
-
-Use `wt config shell install` to add to the shell config automatically."#)]
- Init {
- /// Shell to generate code for
- #[arg(value_enum)]
- shell: Shell,
-
- /// Command name for shell integration (defaults to binary name)
- ///
- /// Use this to create shell integration for an alternate command name.
- /// For example, `--cmd=git-wt` creates a `git-wt` shell function
- /// instead of `wt`, useful on Windows where `wt` conflicts with Windows Terminal.
- #[arg(long)]
- cmd: Option<String>,
- },
-
- /// Write shell integration to config files
- #[command(after_long_help = r#"## Auto setup
-
-Detects existing shell config files and adds integration:
-```console
-wt config shell install
-```
-
-Install for specific shell only:
-```console
-wt config shell install zsh
-```
-
-Shows proposed changes and waits for confirmation before modifying any files.
-Use --yes to skip confirmation."#)]
- Install {
- /// Shell to install (default: all)
- #[arg(value_enum)]
- shell: Option<Shell>,
-
- /// Skip confirmation prompt
- #[arg(short, long)]
- yes: bool,
-
- /// Command name for shell integration (defaults to binary name)
- ///
- /// Use this to create shell integration for an alternate command name.
- /// For example, `--cmd=git-wt` creates a `git-wt` shell function
- /// instead of `wt`, useful on Windows where `wt` conflicts with Windows Terminal.
- #[arg(long)]
- cmd: Option<String>,
- },
-
- /// Remove shell integration from config files
- #[command(after_long_help = r#"## Removal
-
-Removes shell integration lines from config files:
-```console
-wt config shell uninstall
-```
-
-Remove from specific shell only:
-```console
-wt config shell uninstall zsh
-```
-
-Skip confirmation prompt:
-```console
-wt config shell uninstall --yes
-```
-
-## Version tolerance
-
-Detects various forms of the integration pattern regardless of:
-- Command prefix (wt, worktree, etc.)
-- Minor syntax variations between versions"#)]
- Uninstall {
- /// Shell to uninstall (default: all)
- #[arg(value_enum)]
- shell: Option<Shell>,
-
- /// Skip confirmation prompt
- #[arg(short, long)]
- yes: bool,
- },
-
- /// Show output theme samples
- #[command(after_long_help = r#"## Output Theme
-
-Displays samples of all output message types:
-- Progress, success, error, warning, hint, info
-- Gutter formatting for quoted content
-- Prompts for user input
-
-Use this to preview how worktrunk output will appear in the terminal."#)]
- ShowTheme,
-}
-
-#[derive(Subcommand)]
-pub enum ApprovalsCommand {
- /// Store approvals in config
- #[command(
- after_long_help = r#"Prompts for approval of all project commands and saves them to user config.
-
-By default, shows only unapproved commands. Use `--all` to review all commands
-including previously approved ones."#
- )]
- Add {
- /// Show all commands
- #[arg(long)]
- all: bool,
- },
-
- /// Clear approved commands from config
- #[command(
- after_long_help = r#"Removes saved approvals, requiring re-approval on next command run.
-
-By default, clears approvals for the current project. Use `--global` to clear
-all approvals across all projects."#
- )]
- Clear {
- /// Clear global approvals
- #[arg(short, long)]
- global: bool,
- },
-}
-
-#[derive(Subcommand)]
-pub enum ConfigCommand {
- /// Shell integration setup
- Shell {
- #[command(subcommand)]
- action: ConfigShellCommand,
- },
-
- /// Create configuration file
- #[command(
- after_long_help = concat!(
- "## User config\n\n",
- "Creates `~/.config/worktrunk/config.toml` with the following content:\n\n```\n",
- include_str!("../dev/config.example.toml"),
- "```\n\n",
- "## Project config\n\n",
- "With `--project`, creates `.config/wt.toml` in the current repository:\n\n```\n",
- include_str!("../dev/wt.example.toml"),
- "```"
- )
- )]
- Create {
- /// Create project config (`.config/wt.toml`) instead of user config
- #[arg(long)]
- project: bool,
- },
-
- /// Show configuration files & locations
- #[command(
- after_long_help = r#"Shows location and contents of user config (`~/.config/worktrunk/config.toml`)
-and project config (`.config/wt.toml`).
-
-If a config file doesn't exist, shows defaults that would be used.
-
-## Full diagnostics
-
-Use `--full` to run diagnostic checks:
-
-```console
-wt config show --full
-```
-
-This tests:
-- **CI tool status** — Whether `gh` (GitHub) or `glab` (GitLab) is installed and authenticated
-- **Commit generation** — Whether the LLM command can generate commit messages"#
- )]
- Show {
- /// Run diagnostic checks (CI tools, commit generation)
- #[arg(long)]
- full: bool,
- },
-
- /// Manage internal data and cache
- #[command(
- after_long_help = r#"State is stored in `.git/` (config entries and log files), separate from configuration files.
-Use `wt config show` to view file-based configuration.
-
-## Keys
-
-- **default-branch**: The repository's default branch (main, master, etc.)
-- **previous-branch**: Previous branch for `wt switch -`
-- **ci-status**: CI/PR status for a branch (passed, running, failed, conflicts, no-ci, error)
-- **marker**: Custom status marker for a branch (shown in `wt list`)
-- **logs**: Background operation logs
-
-## Examples
-
-Get the default branch:
-```console
-wt config state default-branch
-```
-
-Set the default branch manually:
-```console
-wt config state default-branch set main
-```
-
-Set a marker for current branch:
-```console
-wt config state marker set "🚧 WIP"
-```
-
-Clear all CI status cache:
-```console
-wt config state ci-status clear --all
-```
-
-Show all stored state:
-```console
-wt config state get
-```
-
-Clear all stored state:
-```console
-wt config state clear
-```
-
-<!-- subdoc: default-branch -->
-
-<!-- subdoc: ci-status -->
-
-<!-- subdoc: marker -->
-
-<!-- subdoc: logs -->"#
- )]
- State {
- #[command(subcommand)]
- action: StateCommand,
- },
-}
-
-#[derive(Subcommand)]
-pub enum StateCommand {
- /// Default branch setting
- #[command(
- name = "default-branch",
- after_long_help = r#"## Detection
-
-Worktrunk detects the default branch automatically:
-
-1. **Worktrunk cache** — Checks `git config worktrunk.default-branch` (single command)
-2. **Git cache** — Detects primary remote and checks its HEAD (e.g., `origin/HEAD`)
-3. **Remote query** — If not cached, queries `git ls-remote` (100ms–2s)
-4. **Local inference** — If no remote, infers from local branches
-
-Once detected, the result is cached in `worktrunk.default-branch` for fast access.
-
-The local inference fallback uses these heuristics in order:
-- If only one local branch exists, uses it
-- For bare repos or empty repos, checks `symbolic-ref HEAD`
-- Checks `git config init.defaultBranch`
-- Looks for common names: main, master, develop, trunk
-
-## When to use
-
-Most users never need this command — default branch detection is automatic.
-Use it to:
-
-- **Debug** — See what worktrunk thinks the default branch is
-- **Override** — Set a non-standard default branch with `set`
-- **Refresh** — Force re-query with `get --refresh` after remote changes
-- **Clear** — Remove cached value with `clear`
-
-Without a subcommand, runs `get`. For `--refresh`, use `get --refresh`."#
- )]
- DefaultBranch {
- #[command(subcommand)]
- action: Option<DefaultBranchAction>,
- },
-
- /// Previous branch (for `wt switch -`)
- #[command(
- name = "previous-branch",
- after_long_help = r#"Enables `wt switch -` to return to the previous worktree, similar to `cd -` or `git checkout -`.
-
-## How it works
-
-Updated automatically on every `wt switch`. Stored in git config as `worktrunk.history`.
-
-## When to use
-
-Most users never need this command — the previous branch updates automatically.
-Use it to:
-
-- **Debug** — See what `-` resolves to
-- **Override** — Set a specific branch as "previous"
-- **Clear** — Reset the history
-
-Without a subcommand, runs `get`."#
- )]
- PreviousBranch {
- #[command(subcommand)]
- action: Option<PreviousBranchAction>,
- },
-
- /// CI status cache
- #[command(
- name = "ci-status",
- after_long_help = r#"Caches GitHub/GitLab CI status for display in [`wt list`](@/list.md#ci-status).
-
-## How it works
-
-1. **Platform detection** — From `[ci] platform` in project config, or detected from remote URL (github.com → GitHub, gitlab.com → GitLab)
-2. **CLI requirement** — Requires `gh` (GitHub) or `glab` (GitLab) CLI, authenticated
-3. **What's checked** — PRs/MRs first, then branch pipelines for branches with upstream
-4. **Caching** — Results cached 30-60 seconds per branch+commit
-
-## Status values
-
-| Status | Meaning |
-|--------|---------|
-| `passed` | All checks passed |
-| `running` | Checks in progress |
-| `failed` | Checks failed |
-| `conflicts` | PR has merge conflicts |
-| `no-ci` | No checks configured |
-| `error` | Fetch error (rate limit, network, auth) |
-
-See [`wt list` CI status](@/list.md#ci-status) for display symbols and colors.
-
-## When to use
-
-- **Debug** — See cached status and when it was fetched
-- **Refresh** — Force re-fetch with `get --refresh`
-- **Clear** — Remove stale cache entries
-
-Without a subcommand, runs `get` for the current branch. For `--branch` or `--refresh`, use `get --branch=NAME`."#
- )]
- CiStatus {
- #[command(subcommand)]
- action: Option<CiStatusAction>,
- },
-
- /// Branch markers
- #[command(
- after_long_help = r#"Custom status text or emoji shown in the `wt list` Status column.
-
-## Display
-
-Markers appear at the start of the Status column:
-
-```
-Branch Status Path
-main ^ ~/code/myproject
-feature 🚧↑ ~/code/myproject.feature
-bugfix 🤖!↑⇡ ~/code/myproject.bugfix
-```
-
-## Use cases
-
-- **Work status** — `🚧` WIP, `✅` ready for review, `🔥` urgent
-- **Agent tracking** — The [Claude Code plugin](@/claude-code.md) sets markers automatically
-- **Notes** — Any short text: `"blocked"`, `"needs tests"`
-
-## Storage
-
-Stored in git config as `worktrunk.state.<branch>.marker`. Set directly with:
-
-```console
-git config worktrunk.state.feature.marker '{"marker":"🚧","set_at":0}'
-```
-
-Without a subcommand, runs `get` for the current branch. For `--branch`, use `get --branch=NAME`."#
- )]
- Marker {
- #[command(subcommand)]
- action: Option<MarkerAction>,
- },
-
- /// Background operation logs
- #[command(after_long_help = r#"View and manage logs from background operations.
-
-## What's logged
-
-| Operation | Log file |
-|-----------|----------|
-| post-start hooks | `{branch}-{source}-post-start-{name}.log` |
-| Background removal | `{branch}-remove.log` |
-
-Source is `user` or `project` depending on where the hook is defined.
-
-## Location
-
-All logs are stored in `.git/wt-logs/` (in the main worktree's git directory).
-
-## Behavior
-
-- **Overwrites** — Same operation on same branch overwrites previous log
-- **Persists** — Logs from deleted branches remain until manually cleared
-- **Shared** — All worktrees write to the same log directory
-
-## Examples
-
-List all log files:
-```console
-wt config state logs get
-```
-
-View a specific log:
-```console
-cat "$(git rev-parse --git-dir)/wt-logs/feature-project-post-start-build.log"
-```
-
-Clear all logs:
-```console
-wt config state logs clear
-```"#)]
- Logs {
- #[command(subcommand)]
- action: Option<LogsAction>,
- },
-
- /// One-time hints shown in this repo
- #[command(
- after_long_help = r#"Some hints show once per repo on first use, then are recorded in git config
-as `worktrunk.hints.<name> = true`.
-
-## Current hints
-
-| Name | Trigger | Message |
-|------|---------|---------|
-| `worktree-path` | First `wt switch --create` | Customize worktree locations: wt config create |
-
-## Examples
-
-```console
-wt config state hints # list shown hints
-wt config state hints clear # re-show all hints
-wt config state hints clear NAME # re-show specific hint
-```"#
- )]
- Hints {
- #[command(subcommand)]
- action: Option<HintsAction>,
- },
-
- /// Get all stored state
- #[command(after_long_help = r#"Shows all stored state including:
-
-- **Default branch**: Cached result of querying remote for default branch
-- **Previous branch**: Previous branch for `wt switch -`
-- **Branch markers**: User-defined branch notes
-- **CI status**: Cached GitHub/GitLab CI status per branch (30s TTL)
-- **Hints**: One-time hints that have been shown
-- **Log files**: Background operation logs
-
-CI cache entries show status, age, and the commit SHA they were fetched for."#)]
- Get {
- /// Output format (table, json)
- #[arg(long, value_enum, default_value = "table", hide_possible_values = true)]
- format: OutputFormat,
- },
-
- /// Clear all stored state
- #[command(after_long_help = r#"Clears all stored state:
-
-- Default branch cache
-- Previous branch
-- All branch markers
-- All CI status cache
-- All hints
-- All log files
-
-Use individual subcommands (`default-branch clear`, `ci-status clear --all`, etc.)
-to clear specific state."#)]
- Clear,
-}
-
-#[derive(Subcommand)]
-pub enum DefaultBranchAction {
- /// Get the default branch
- #[command(after_long_help = r#"## Examples
-
-Get the default branch:
-```console
-wt config state default-branch
-```
-
-Force refresh from remote:
-```console
-wt config state default-branch get --refresh
-```"#)]
- Get {
- /// Force refresh from remote
- #[arg(long)]
- refresh: bool,
- },
-
- /// Set the default branch
- #[command(after_long_help = r#"## Examples
-
-Set the default branch:
-```console
-wt config state default-branch set main
-```"#)]
- Set {
- /// Branch name to set as default
- #[arg(add = crate::completion::branch_value_completer())]
- branch: String,
- },
-
- /// Clear the default branch cache
- Clear,
-}
-
-#[derive(Subcommand)]
-pub enum PreviousBranchAction {
- /// Get the previous branch
- #[command(after_long_help = r#"## Examples
-
-Get the previous branch (used by `wt switch -`):
-```console
-wt config state previous-branch
-```"#)]
- Get,
-
- /// Set the previous branch
- #[command(after_long_help = r#"## Examples
-
-Set the previous branch:
-```console
-wt config state previous-branch set feature
-```"#)]
- Set {
- /// Branch name to set as previous
- #[arg(add = crate::completion::branch_value_completer())]
- branch: String,
- },
-
- /// Clear the previous branch
- Clear,
-}
-
-#[derive(Subcommand)]
-pub enum CiStatusAction {
- /// Get CI status for a branch
- #[command(
- after_long_help = r#"Returns: passed, running, failed, conflicts, no-ci, or error.
-
-## Examples
-
-Get CI status for current branch:
-```console
-wt config state ci-status
-```
-
-Force refresh from GitHub/GitLab:
-```console
-wt config state ci-status get --refresh
-```
-
-Get CI status for a specific branch:
-```console
-wt config state ci-status get --branch=feature
-```"#
- )]
- Get {
- /// Force refresh from GitHub/GitLab
- #[arg(long)]
- refresh: bool,
-
- /// Target branch (defaults to current)
- #[arg(long, add = crate::completion::branch_value_completer())]
- branch: Option<String>,
- },
-
- /// Clear CI status cache
- #[command(after_long_help = r#"## Examples
-
-Clear CI status for current branch:
-```console
-wt config state ci-status clear
-```
-
-Clear CI status for a specific branch:
-```console
-wt config state ci-status clear --branch=feature
-```
-
-Clear all CI status cache:
-```console
-wt config state ci-status clear --all
-```"#)]
- Clear {
- /// Target branch (defaults to current)
- #[arg(long, add = crate::completion::branch_value_completer(), conflicts_with = "all")]
- branch: Option<String>,
-
- /// Clear all CI status cache
- #[arg(long)]
- all: bool,
- },
-}
-
-#[derive(Subcommand)]
-pub enum MarkerAction {
- /// Get marker for a branch
- #[command(after_long_help = r#"## Examples
-
-Get marker for current branch:
-```console
-wt config state marker
-```
-
-Get marker for a specific branch:
-```console
-wt config state marker get --branch=feature
-```"#)]
- Get {
- /// Target branch (defaults to current)
- #[arg(long, add = crate::completion::branch_value_completer())]
- branch: Option<String>,
- },
-
- /// Set marker for a branch
- #[command(after_long_help = r#"## Examples
-
-Set marker for current branch:
-```console
-wt config state marker set "🚧 WIP"
-```
-
-Set marker for a specific branch:
-```console
-wt config state marker set "✅ ready" --branch=feature
-```"#)]
- Set {
- /// Marker text (shown in `wt list` output)
- value: String,
-
- /// Target branch (defaults to current)
- #[arg(long, add = crate::completion::branch_value_completer())]
- branch: Option<String>,
- },
-
- /// Clear marker for a branch
- #[command(after_long_help = r#"## Examples
-
-Clear marker for current branch:
-```console
-wt config state marker clear
-```
-
-Clear marker for a specific branch:
-```console
-wt config state marker clear --branch=feature
-```
-
-Clear all markers:
-```console
-wt config state marker clear --all
-```"#)]
- Clear {
- /// Target branch (defaults to current)
- #[arg(long, add = crate::completion::branch_value_completer(), conflicts_with = "all")]
- branch: Option<String>,
-
- /// Clear all markers
- #[arg(long)]
- all: bool,
- },
-}
-
-#[derive(Subcommand)]
-pub enum LogsAction {
- /// List background operation log files
- #[command(
- after_long_help = r#"Lists log files from background operations like post-start commands and worktree removal.
-
-## Examples
-
-List log files:
-```console
-wt config state logs
-```"#
- )]
- Get,
-
- /// Clear background operation logs
- Clear,
-}
-
-#[derive(Subcommand)]
-pub enum HintsAction {
- /// List hints that have been shown
- #[command(
- after_long_help = r#"Lists which one-time hints have been shown in this repository.
-
-## Examples
-
-List shown hints:
-```console
-wt config state hints
-```"#
- )]
- Get,
-
- /// Clear hints (re-show on next trigger)
- #[command(
- after_long_help = r#"Clears hint state so hints will show again on next trigger.
-
-## Examples
-
-Clear all hints:
-```console
-wt config state hints clear
-```
-
-Clear a specific hint:
-```console
-wt config state hints clear worktree-path
-```"#
- )]
- Clear {
- /// Specific hint to clear (clears all if not specified)
- name: Option<String>,
- },
-}
-
/// Run individual operations
#[derive(Subcommand)]
pub enum StepCommand {
@@ -1092,228 +358,6 @@ Note: This command is experimental and may change in future versions.
},
}
-/// Run configured hooks
-#[derive(Subcommand)]
-pub enum HookCommand {
- /// Show configured hooks
- ///
- /// Lists user and project hooks. Project hooks show approval status (❓ = needs approval).
- Show {
- /// Hook type to show (default: all)
- #[arg(value_parser = ["post-create", "post-start", "post-switch", "pre-commit", "pre-merge", "post-merge", "pre-remove"])]
- hook_type: Option<String>,
-
- /// Show expanded commands with current variables
- #[arg(long)]
- expanded: bool,
- },
-
- /// Run post-create hooks
- ///
- /// Blocking — waits for completion before continuing.
- PostCreate {
- /// Filter by command name
- ///
- /// Supports `user:name` or `project:name` to filter by source.
- /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
- #[arg(add = crate::completion::hook_command_name_completer())]
- name: Option<String>,
-
- /// Skip approval prompts
- #[arg(short, long)]
- yes: bool,
-
- /// Override built-in template variable (KEY=VALUE)
- #[arg(long = "var", value_name = "KEY=VALUE", value_parser = parse_key_val, action = clap::ArgAction::Append)]
- vars: Vec<(String, String)>,
- },
-
- /// Run post-start hooks
- ///
- /// Background by default. Use `--foreground` to run in foreground for debugging.
- PostStart {
- /// Filter by command name
- ///
- /// Supports `user:name` or `project:name` to filter by source.
- /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
- #[arg(add = crate::completion::hook_command_name_completer())]
- name: Option<String>,
-
- /// Skip approval prompts
- #[arg(short, long)]
- yes: bool,
-
- /// Run in foreground (block until complete)
- #[arg(long)]
- foreground: bool,
-
- /// Deprecated: use --foreground instead
- #[arg(long = "no-background", hide = true)]
- no_background: bool,
-
- /// Override built-in template variable (KEY=VALUE)
- #[arg(long = "var", value_name = "KEY=VALUE", value_parser = parse_key_val, action = clap::ArgAction::Append)]
- vars: Vec<(String, String)>,
- },
-
- /// Run post-switch hooks
- ///
- /// Background by default. Use `--foreground` to run in foreground for debugging.
- PostSwitch {
- /// Filter by command name
- ///
- /// Supports `user:name` or `project:name` to filter by source.
- /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
- #[arg(add = crate::completion::hook_command_name_completer())]
- name: Option<String>,
-
- /// Skip approval prompts
- #[arg(short, long)]
- yes: bool,
-
- /// Run in foreground (block until complete)
- #[arg(long)]
- foreground: bool,
-
- /// Deprecated: use --foreground instead
- #[arg(long = "no-background", hide = true)]
- no_background: bool,
-
- /// Override built-in template variable (KEY=VALUE)
- #[arg(long = "var", value_name = "KEY=VALUE", value_parser = parse_key_val, action = clap::ArgAction::Append)]
- vars: Vec<(String, String)>,
- },
-
- /// Run pre-commit hooks
- PreCommit {
- /// Filter by command name
- ///
- /// Supports `user:name` or `project:name` to filter by source.
- /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
- #[arg(add = crate::completion::hook_command_name_completer())]
- name: Option<String>,
-
- /// Skip approval prompts
- #[arg(short, long)]
- yes: bool,
-
- /// Override built-in template variable (KEY=VALUE)
- #[arg(long = "var", value_name = "KEY=VALUE", value_parser = parse_key_val, action = clap::ArgAction::Append)]
- vars: Vec<(String, String)>,
- },
-
- /// Run pre-merge hooks
- PreMerge {
- /// Filter by command name
- ///
- /// Supports `user:name` or `project:name` to filter by source.
- /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
- #[arg(add = crate::completion::hook_command_name_completer())]
- name: Option<String>,
-
- /// Skip approval prompts
- #[arg(short, long)]
- yes: bool,
-
- /// Override built-in template variable (KEY=VALUE)
- #[arg(long = "var", value_name = "KEY=VALUE", value_parser = parse_key_val, action = clap::ArgAction::Append)]
- vars: Vec<(String, String)>,
- },
-
- /// Run post-merge hooks
- PostMerge {
- /// Filter by command name
- ///
- /// Supports `user:name` or `project:name` to filter by source.
- /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
- #[arg(add = crate::completion::hook_command_name_completer())]
- name: Option<String>,
-
- /// Skip approval prompts
- #[arg(short, long)]
- yes: bool,
-
- /// Override built-in template variable (KEY=VALUE)
- #[arg(long = "var", value_name = "KEY=VALUE", value_parser = parse_key_val, action = clap::ArgAction::Append)]
- vars: Vec<(String, String)>,
- },
-
- /// Run pre-remove hooks
- PreRemove {
- /// Filter by command name
- ///
- /// Supports `user:name` or `project:name` to filter by source.
- /// `user:` alone runs all user hooks; `project:` alone runs all project hooks.
- #[arg(add = crate::completion::hook_command_name_completer())]
- name: Option<String>,
-
- /// Skip approval prompts
- #[arg(short, long)]
- yes: bool,
-
- /// Override built-in template variable (KEY=VALUE)
- #[arg(long = "var", value_name = "KEY=VALUE", value_parser = parse_key_val, action = clap::ArgAction::Append)]
- vars: Vec<(String, String)>,
- },
-
- /// Manage command approvals
- #[command(after_long_help = r#"## How Approvals Work
-
-Commands from project hooks (`.config/wt.toml`) require approval on first run.
-This prevents untrusted projects from running arbitrary commands.
-
-**Approval flow:**
-1. Command is shown as a template (variables not expanded)
-2. User approves or denies
-3. Approved commands are saved to user config under `[projects."project-id"]`
-
-**When re-approval is required:**
-- Command template changes (not just variable values)
-- Project ID changes (repository moves)
-
-**Bypassing prompts:**
-- `--yes` flag on individual commands (e.g., `wt merge --yes`)
-- Useful for CI/automation where prompts aren't possible
-
-## Examples
-
-Pre-approve all commands for current project:
-```console
-wt hook approvals add
-```
-
-Clear approvals for current project:
-```console
-wt hook approvals clear
-```
-
-Clear global approvals:
-```console
-wt hook approvals clear --global
-```"#)]
- Approvals {
- #[command(subcommand)]
- action: ApprovalsCommand,
- },
-}
-
-/// Subcommands for `wt list`
-#[derive(Subcommand)]
-pub enum ListSubcommand {
- /// Single-line status for shell prompts
- ///
- /// For shell prompts, starship, or editor integrations.
- #[command(after_long_help = "Format: `branch status ±working commits upstream ci`")]
- Statusline {
- /// Claude Code mode: read context from stdin, add directory and model
- ///
- /// Reads JSON from stdin with `.workspace.current_dir` and `.model.display_name`.
- /// Output: `dir branch status ±working commits upstream ci | model`
- #[arg(long)]
- claude_code: bool,
- },
-}
-
#[derive(Subcommand)]
pub enum Commands {
/// Switch to a worktree