Recursively check out a git branch across root repository and nested submodules.
npx skills add https://github.com/geoyws/atmux --skill rcheckout
Please help me install this Agent Skill. Skill: rcheckout Source: https://github.com/geoyws/atmux/tree/main/.claude/skills/rcheckout Command: npx skills add https://github.com/geoyws/atmux --skill rcheckout
It eliminates the hassle of manually updating a repository plus deeply nested git submodules so they all land on the same target branch, even when some submodules are on detached HEADs or the branch only exists on the remote.
Tell the Skill to run /rcheckout myteam-alpha-dev to switch the root repo and all nested submodules to myteam-alpha-dev.
High-intent search queries and answers about installing and using this skill.
To checkout a branch across all git submodules in a monorepo, you can use a recursive checkout script that switches the root repository and every nested submodule to the target branch in a single operation. This aligns deeply nested codebases for coordinated team workflows.
Switching a git submodule from a detached HEAD state to a specific branch requires attaching the detached HEAD to the target branch. A recursive checkout tool automates this by creating the branch from origin when it only exists on the remote.
If a submodule branch only exists on the remote origin, the recursive checkout process fetches and creates the local branch from origin/<branch>. This ensures all nested submodules align with the target branch even if it is not yet tracked locally.
To identify which submodules failed to switch branches, review the operator-oriented reporting generated by the checkout process. It produces a summary plus per-repo WARN lines indicating what succeeded, partially failed, or requires manual intervention.
You cannot checkout all submodules without specifying a branch name, as the branch argument is mandatory. Requiring a specific branch name prevents ambiguous selections based on the .gitmodules file and ensures the correct branch is applied recursively.
acartineCheckout the main branch and pull latest changes from the remote.
kjgarzaGenerate monorepo scaffolds with apps, services, and packages directories.
idvorkinSync local git repositories with upstream or origin main branches.
SocketDevDetermine and apply minimal sparse-checkout patterns for .gitmodules submodules using Bash and Node.js scripts.
