Fell

CLI tool that help's you actively manage, prune and delete worktrees. "To fell a tree."

Why?

Git worktrees accumulate. Agent tools (Cursor, Claude Code) create them freely. After a few weeks you have a dozen stale worktrees, some with merged PRs, some with unpushed changes, and git worktree list gives you a wall of paths with no context.

fell shows you what each worktree actually is -- its PR status, whether it has uncommitted work, and how far behind it is -- so you can clean up confidently.

Install

bun add -g @doccy/fell

Requires Bun and git. GitHub CLI (gh) is optional -- enables PR status display.

Usage

fell                              # interactive TUI
fell --list                       # print worktrees + PR statuses and exit
fell --recycle <branch>           # recycle a worktree for a new branch
fell --recycle <branch> --slot <path>  # recycle a specific worktree
fell --help                       # show help

Interactive commands

up/down or k/j   Navigate worktree list
space             Toggle selection
a                 Select / deselect all
e                 Expand / collapse file list
o                 Open worktree -> f finder, c cursor
c                 Release worktree(s) for recycling (detach HEAD)
d                 Delete worktree(s) + optionally branches
p                 Prune stale references
r                 Refresh list + PR statuses
?                 Help (terminology explained)
q / ctrl+c        Quit

What you see

• Branch name, PR status, size, and recyclable indicators for each worktree
• File status sub-lines (staged, modified, untracked, unpushed, behind) with warning indicators
• Expand (e) to see SHA, session info, and changed file list
• Focused item shows full path and PR title
• PR numbers are clickable links in supported terminals (iTerm2, Kitty, WezTerm)

Terminology

release detaches HEAD from a worktree without deleting the directory. The worktree becomes an empty slot with its dependencies intact, ready to be recycled for a new branch via fell --recycle <branch>. Non-destructive.

delete properly removes a worktree from disk and cleans up git tracking. Optionally also deletes the branch. Equivalent to git worktree remove. Destructive.

prune cleans up stale administrative references -- when a worktree directory has been manually deleted (rm -rf) but git still tracks it. Equivalent to git worktree prune. Safe: only affects already-missing worktrees.

License

MIT