Quick start

Run these commands inside a Git repository.

Create a workspace

hwt create --branch feat/my-change

hwt uses the current branch as the base, asks Herdr to create a linked worktree and workspace, applies your configuration, and leaves focus where it is.

Focus the new workspace immediately with --focus:

hwt create --branch feat/my-change --focus

Add repository setup

Generate .herdr-worktree.yaml:

hwt config init

Then describe what each new checkout needs:

# yaml-language-server: $schema=https://raw.githubusercontent.com/dkarter/hwt/main/schema/herdr-worktree.schema.json
agent: opencode --port
files:
  copy:
    - .env.local
post_create:
  - mise install

Validate the resolved global and repository configuration:

hwt config validate

Inspect worktrees

hwt list

Remove the workspace

From inside the Herdr workspace:

hwt remove

From elsewhere, provide its workspace ID:

hwt remove --workspace w_8Jx2

hwt refuses to remove a dirty or locked worktree. Review the checkout before using --force.