Regraft

Regraft is a tool for copying code from a git repository, adapting it to a project, and later pulling upstream updates back in. It is built around preserving where copied files came from and why they were changed, so updates can be merged after local editing rather than treated as a one-time copy.

Its workflow centers on five commands: add, note, status, pull, and resolve. The add command copies a directory or a single file from a git repo into another repo and records the source commit and original file contents in regraft.json. After editing, note adds a one-sentence explanation that is saved in PATCH.md. When upstream changes appear, pull brings them in with a three-way merge, using diff3. Changes that do not overlap with local edits merge automatically, while real conflicts produce markers and a brief explaining both sides before resolve is used. The tool also includes diff and diff --upstream for comparing local changes and incoming updates.

Regraft is intended for repositories that can be reached with git clone using the user’s existing credentials, including GitHub, GitLab, self-hosted, private, and other git hosts. It supports whole repos, branches, tags, directories, single files, and open pull requests, and its commands can output JSON. The page also says regraft status exits 1 when something needs attention, which makes it suitable for CI and for coding agents that need to process machine-readable output.

Installation is shown with a shell script using curl, and the site lists macOS, Linux, and Windows. Regraft is free and open source, and the page points to GitHub and documentation for the command reference. Treadie, Inc. is named in the site footer.