How do I install the Ff Worktrees skill?

Run npx skillmds@latest add damus-io/ff-worktrees in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ff Worktrees safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ff Worktrees?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ff Worktrees free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ff Worktrees?

damus-io (@damus-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ff Worktrees by damus-io — Agent Skill

Name: Ff Worktrees
Author: damus-io

Ff Worktrees

Fast-forward master and every git worktree branch up to a target ref (default github/master), skipping any worktree with unmerged commits. Use when the user wants to sync/update their worktree branches to latest master — e.g. "/ff-worktrees", "ff all worktrees to github/master", "fast-forward the worktrees".

damus-io da1d881 1.7 KB Updated Sep 17, 2026

File contents

ff-worktrees

Fast-forwards master and every branch checked out in a git worktree up to a target ref. Only true fast-forwards are applied: a branch is advanced solely when it is already an ancestor of the target. Worktree branches carrying their own unmerged commits are left untouched and reported as skipped, so no work is ever clobbered.

Running it

scripts/ff-worktrees.sh [target]

target — ref to fast-forward toward. Defaults to github/master. When it looks like <remote>/<branch> and <remote> is configured, the remote is fetched first.

Examples:

scripts/ff-worktrees.sh                 # ff everything to github/master
scripts/ff-worktrees.sh origin/master   # ff everything to origin/master

Behavior

Fetches the target's remote first (when the target is <remote>/<branch>).
Fast-forwards each branch in place inside its worktree via merge --ff-only; untracked files and non-conflicting local edits survive.
A branch not checked out in any worktree (e.g. master when it's idle) has its ref moved directly, still guarded by an ancestry (fast-forward) check.
Reports a one-line summary per branch: + advanced, = already up to date, ~ skipped for unmerged commits, ! skipped because a dirty worktree blocks the fast-forward.

Safe to run from any worktree — it never resets a branch or discards commits.

Frequently asked questions