worktree

Small CLI to work with git bare repos and worktrees with easy-to-remember commands.

Version: 0.1.0

Help Output

worktree 0.1.0

Usage
  worktree <command>

Repo Commands
  repo init                               Initialize a bare repo here and create main/
  repo create <folder>                    Create a new bare-layout repo in <folder>/
  repo clone <remote>                     Clone a remote into this bare-layout repo
  repo convert <folder>                   Convert <folder>/ into <folder>/.bak + bare-layout <folder>/
  repo set-remote <remote>                Set or replace origin and fetch refs
  repo info                               Alias for repo show
  repo show                               Show repo root, origin, and branch hints

Worktree Commands
  create <prefix> <description>           Create a new branch worktree
  create <prefix>/<description>           Same as above, slash form
  branch <branch>                         Reuse or create a worktree for an existing branch
  show                                    List registered worktrees
  prune-removed-folders                   Prune deleted worktree folders
  repair [<path>...]                      Repair broken worktree links

Workflows
  completions <shell>                     Generate shell completion script

Notes
  create prefixes: feature, fix, chore, hotfix
  repo convert expects a clean normal repo and keeps <folder>.bak as backup
  repair needs moved worktree path(s) when linked folders were relocated manually

Examples
  worktree repo create EffectfulFlow
  worktree repo clone git@github.com:me/EffectfulFlow.git
  worktree repo convert EffectfulFlow
  worktree create feature add-thing
  worktree branch feature/add-thing
  worktree repair
  worktree repair ../mylibs/CodecMapper/main

Build

There's currently no prebuilt binaries, build your own and put on path...

mise run build
mise run test
dotnet publish src/Worktree/Worktree.fsproj -c Release -r linux-x64

For native AOT (linux64):

mise run publish-aot

Build output is centralized under artifacts/ via the .NET SDK artifacts layout.

Shell Completions

You can enable tab completion for your shell by adding the following to your shell configuration file.

Bash

Add this to your ~/.bashrc:

source <(worktree completions bash)

Zsh

Add this to your ~/.zshrc:

source <(worktree completions zsh)

Fish

Add this to your ~/.config/fish/config.fish:

worktree completions fish | source

PowerShell

Add this to your $PROFILE:

Invoke-Expression (&worktree completions powershell | Out-String)

Tooling

• .NET 10 is pinned in global.json
• mise manages the local SDK via mise.toml