rcheckout

Community

Switch root and all submodules to a branch

Authorgeoyws
Version1.0.0
Installs0

System Documentation

What problem does it solve?

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.

Core Features & Use Cases

  • Recursive submodule checkout: Switches the root repo and every nested submodule to the provided branch in one operation.
  • Detached HEAD and branch-from-remote handling: Attaches detached HEADs to the target branch and creates the branch from origin/<branch> when needed.
  • Operator-oriented reporting: Produces a summary plus per-repo WARN lines so you can quickly identify what succeeded, what partially failed, and what requires manual intervention.

Quick Start

Tell the Skill to run /rcheckout myteam-alpha-dev to switch the root repo and all nested submodules to myteam-alpha-dev.

Dependency Matrix

Required Modules

None required

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: rcheckout
Download link: https://github.com/geoyws/atmux/archive/main.zip#rcheckout

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.