CLI Overview

Use the CLI to manage worktrees non-interactively, in scripts, and from coding agents.

Available Commands

• lazyworktree list
• lazyworktree create
• lazyworktree delete
• lazyworktree rename
• lazyworktree doctor
• lazyworktree worktrees ...
• lazyworktree notes get
• lazyworktree exec
• lazyworktree describe

Global config overrides:

lazyworktree --worktree-dir ~/worktrees
lazyworktree --config lw.theme=nord --config lw.sort_mode=active

Command Pages

• doctor
• worktrees
• notes
• list
• create
• delete
• rename
• exec
• commands reference
• flags reference

For complete generated references, use:

• CLI Commands Reference
• CLI Flags Reference
• lazyworktree --help
• man lazyworktree

Machine-first workflow

For Codex or script automation, prefer this order:

1. lazyworktree describe
2. lazyworktree doctor --json
3. lazyworktree worktrees list --json
4. lazyworktree worktrees resolve --name <name> --json
5. lazyworktree worktrees get <path-or-name> --json
6. lazyworktree worktrees context <path-or-name> --json
7. lazyworktree notes get <path-or-name> --json