#wt

#Usage

$ wt ls
NAME BRANCH PR GIT PATH
main main main pushed /path/to/repository
feature feature OPEN(#42) committed /path/to/feature

#Key features

• Lists each Git worktree with its branch, pull-request state, Git state, and path.
• Detects open, merged, closed, absent, and unknown pull-request states through the GitHub CLI.
• Removes only non-main worktrees whose branches are pushed and whose pull request is merged, closed, or absent.
• Supports a dry-run mode for inspecting cleanup candidates without changing files.

#Prerequisites

• Git: Required for worktree discovery, status inspection, and cleanup.
• GitHub CLI (gh): Required for pull-request state lookup; without it, pull-request state may be reported as unknown.
• GitHub remote: The repository must have an origin remote using an https://github.com/... or git@github.com:... URL for pull-request lookups.
• GitHub CLI authentication: Run gh auth login when pull-request state is needed.
• MoonBit: Install MoonBit.
• Nix: Enable flakes. The exported package and overlay support exactly aarch64-darwin and x86_64-linux.

#Setup

#Run without installing

moonx --target native totto2727/wt ls
nix run github:totto2727-org/wt#wt -- ls

#Install

moon install totto2727/wt
nix profile add github:totto2727-org/wt#wt

#Nix flake

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    wt.url = "github:totto2727-org/wt";
  };

  outputs = { nixpkgs, wt, ... }:
    let
      system = "aarch64-darwin"; # Use x86_64-linux on Linux.
      pkgs = import nixpkgs {
        inherit system;
        overlays = [ wt.overlays.default ];
      };
    in
    {
      devShells.${system}.default = pkgs.mkShell {
        packages = [ pkgs.wt ];
      };
    };
}

#API

#wt

$ wt --help

#wt help

$ wt help cleanup

#wt ls [dir]

$ wt ls /path/to/repository

#wt cleanup [dir] [--dry-run|-n]

$ wt cleanup --dry-run /path/to/repository
$ wt cleanup -n

#Development

#License