apenwarr/git-subtree

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

1384 stars · 125 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

git-subtree is a Shell-based Git extension that lets you merge subprojects into a repository's subtree and split them back out, serving as an alternative to git-submodule. It keeps subproject history in the main repository rather than using separate checkouts.

Use cases

• manage a vendored dependency inside my git repo without submodules
• split a subdirectory of my repo into its own project while preserving history
• merge an external repository into a subfolder of my project
• push changes made in a subtree back to the upstream subproject
• avoid the pain of git submodules for shared libraries
• keep a monorepo with components that can still be published separately

When to choose

• you want dependencies stored directly in your repository history instead of as submodule pointers
• you need to extract a subdirectory into a standalone repo with full commit history
• your team finds git-submodule workflows confusing or error-prone
• you vendor third-party code but occasionally need to sync changes upstream

When to avoid

• you need lightweight submodule pointers without duplicating history in your repo
• you want a tool with active development and recent releases (this project's last release was 2017 and its functionality was merged into core Git)
• you only need modern Git's built-in subtree support, which ships with Git itself

Facets

cli-tool · maturity maintenance

version-control cli developer-tools version-control developer-tools cli cross-platform git subtree submodules-alternative shell monorepo command-line

Member repositories

For agents

markdown · JSON · MCP: product_card(name="apenwarr/git-subtree")