Install and create
Install hwt through mise, then create a workspace from any Git repository.
hwt documentation
Turn a Git branch into a configured Herdr workspace with one repeatable command.
Start with a working workspace
Section titled “Start with a working workspace”hwt wraps Herdr’s native worktree lifecycle with repository policy. It decides where the checkout belongs, transfers the files the branch needs, runs setup commands, and returns the new workspace and pane IDs.
Make it repeatable
Add .herdr-worktree.yaml to describe placement, copy strategies, and post-create setup.
Automate with JSON
Give agents stable machine-readable workspace, pane, checkout, and branch details.
What hwt controls
Section titled “What hwt controls”- Placement: choose a shared worktree directory and deterministic checkout name.
- Context: copy, APFS-clone, or symlink repository-relative files and directories.
- Setup: run ordered commands after all file operations finish.
- Lifecycle: create and remove Herdr workspaces while respecting dirty and locked worktrees.
- Output: expose structured results for coding agents and scripts.