feat: ez branch — list branches with PR numbers and worktree paths

Non-interactive branch listing for agents. Shows all managed branches
with current branch marker (*), associated PR number, and worktree
path if checked out in a worktree.

Agents use `ez branch` to discover branches before `ez checkout <name>`,
avoiding the interactive TUI picker.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: rohoswagger

CLAUDE.md

@@ -129,6 +129,7 @@ These features exist specifically to make ez useable by AI agents:
 | 0.1.12 | `ez update` — self-update command, auto-detects install method (cargo vs script), `--check` for version check without install, `--version` for specific version |
 | 0.1.13 | Examples in every `--help`, commit SHA in output, `ez worktree delete --yes` from inside worktree, `worktree_path` fix for linked worktrees |
 | 0.1.14 | Phased worktree create/delete: validate→mutate→output with rollback on failure; chdir before worktree remove; prune stale entries; recover from broken worktree state |
+| 0.1.15 | `ez branch` — list all branches with PR numbers and worktree paths |
 
 ---
 

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "ez-stack"
-version = "0.1.14"
+version = "0.1.15"
 edition = "2024"
 rust-version = "1.85"
 description = "A CLI tool for managing stacked PRs with GitHub"

Cargo.toml

@@ -202,6 +202,7 @@ Exit codes: 0=ok, 2=gh error, 3=conflict, 4=stale ref, 5=usage error, 6=unstaged
 | `ez diff --stat` | Show only the diffstat summary |
 | `ez diff --name-only` | Show only changed file names |
 | `ez parent` | Print the parent branch name to stdout (pipeable) |
+| `ez branch` | List all branches with PR numbers and worktree paths |
 
 ### Updating
 

README.md

@@ -82,6 +82,7 @@ ez-stack is a CLI for managing stacked PRs on GitHub. When `.git/ez/stack.json`
 | Show stack tree as JSON | `ez log --json` |
 | Show current branch info | `ez status` |
 | Show status as JSON | `ez status --json` |
+| List all branches (with PRs and worktree paths) | `ez branch` |
 
 ### Worktrees
 

SKILL.md

@@ -216,6 +216,13 @@ Examples:
         json: bool,
     },
 
+    /// List all branches in the stack with PR numbers and worktree paths
+    #[command(after_help = "\
+Examples:
+  ez branch
+  ez branch | grep feat/")]
+    Branch,
+
     /// Show diff of current branch vs its parent (what the PR reviewer sees)
     #[command(after_help = "\
 Examples:

src/cli.rs

@@ -0,0 +1,36 @@
+use anyhow::Result;
+use std::collections::HashMap;
+
+use crate::git;
+use crate::stack::StackState;
+use crate::ui;
+
+pub fn run() -> Result<()> {
+    let state = StackState::load()?;
+    let current = git::current_branch()?;
+
+    // Build branch→worktree path map.
+    let worktree_map: HashMap<String, String> = git::worktree_list()
+        .unwrap_or_default()
+        .into_iter()
+        .filter_map(|wt| wt.branch.map(|b| (b, wt.path)))
+        .collect();
+
+    let order = state.topo_order();
+
+    for branch in &order {
+        let meta = state.get_branch(branch)?;
+
+        let marker = if *branch == current { "* " } else { "  " };
+        let pr = meta.pr_number.map(|n| format!(" #{n}")).unwrap_or_default();
+        let wt = worktree_map
+            .get(branch.as_str())
+            .map(|p| format!(" {}", ui::dim(p)))
+            .unwrap_or_default();
+
+        // Machine-readable to stdout: marker, name, PR, worktree path.
+        println!("{marker}{branch}{pr}{wt}");
+    }
+
+    Ok(())
+}

src/cmd/branch.rs

@@ -1,4 +1,5 @@
 pub mod amend;
+pub mod branch;
 pub mod checkout;
 pub mod commit;
 pub mod create;

src/cmd/mod.rs

@@ -154,6 +154,7 @@ fn run(cli: Cli) -> Result<()> {
         Commands::Top => cmd::navigate::top(),
         Commands::Bottom => cmd::navigate::bottom(),
         Commands::Checkout { name } => cmd::checkout::run(name.as_deref()),
+        Commands::Branch => cmd::branch::run(),
         Commands::Log { json } => cmd::log::run(json),
         Commands::Status { json } => cmd::status::run(json),
         Commands::Diff { stat, name_only } => cmd::diff::run(stat, name_only),