Sync Worktrees — AI skill for Claude Code

sync-worktrees

Keep every branch checked out. Switching is just `cd`.

[](https://www.npmjs.com/package/sync-worktrees) [](https://sync-worktrees.com) [](#install-and-quick-start) [](#install-and-quick-start) [](./LICENSE) [](https://github.com/yordan-kanchelov/sync-worktrees/actions/workflows/release.yml)

sync-worktrees turns each Git branch, in every repository you declare, into a folder on disk and keeps it in sync with the remote. Git history is stored once per repository; dirty trees are never touched and unpushed commits are never discarded. A new machine is one config file.

**Contents:** [What you get](#what-you-get) · [Why](#why-sync-worktrees) · [How it works](#how-it-works) · [What it will never do](#what-it-will-never-do) · [Install and quick start](#install-and-quick-start) · [Configuration](#configuration) · [Interactive TUI](#interactive-tui) · [Optional MCP server](#optional-mcp-server) · [CLI reference](#cli-reference) · [Documentation](#documentation) · [Contributing](#contributing) · [License](#license)

What you get

npm install -g sync-worktrees   # Node 24+, macOS or Linux
sync-worktrees init             # wizard → writes sync-worktrees.config.js
sync-worktrees                  # TUI: syncs now, then hourly; add --runOnce for a one-shot

With one repository declared and `init`'s default `worktreeDir` (`./`), the directory holding the config becomes:

.
├── sync-worktrees.config.js
├── .bare/
│   └── my-repo/                   # Git history, stored once
└── my-repo/