pf

pf

A humane utility for git worktrees.

Install

npm i -g pf

Usage

pf <command> [options]

Commands:
  new [name]   Create a branch and worktree with the specified name (default: "pf-[hash]")
  open <name>  Open a worktree in a subshell
  ls           List all tracked worktrees
  rm <name>    Remove a worktree

Options:
  --help, -h       Show help
  --version, -v    Show version

Why pf?

In agentic development, you often want to spin up isolated workspaces for specific tasks—without stashing or committing your current changes. pf makes this effortless.

Create a new worktree for a task:

$ pf new add-login-button

This creates a branch and worktree, then drops you into a subshell. Open it in your editor or point an AI coding agent at it. Your changes are completely independent of any other work on your machine.

When you're done, push to GitHub and create a PR:

$ git push -u origin add-login-button

Or merge directly back into main:

$ git checkout main && git merge add-login-button

Then just exit to pop out of the worktree and back to your main repo. Clean up when you're done:

$ pf rm add-login-button

Use pf ls to see your active worktrees, and pf open <name> to return to one later.