rename-repo

Bulk renames GitHub repositories and optionally updates their descriptions.

Usage

git-wrangler rename-repo [--repo <path>] [--description]

What it does

Discovers Git worktrees under the current directory, or targets exactly one worktree with --repo. For each repository, it asks gh repo view for the current GitHub repository name and prompts for a new name. If --description is provided, it also shows the current description and prompts for a replacement.

This command is intentionally interactive. There is no --yes; blank prompts skip that repository or field.

Options

FlagRequiredDescription
--repo <path>OptionalTarget exactly one repository instead of discovering recursively.
--descriptionOptionalAlso prompt to update the repository description.

Prerequisites

  • gh (GitHub CLI) must be installed
  • Git Wrangler GitHub auth must be configured with git-wrangler init, git-wrangler config set github.auth, or GIT_WRANGLER_GITHUB_TOKEN
  • Each local repository must be identifiable by gh repo view

Examples

# Rename repos only
git-wrangler rename-repo

# Rename repos and update descriptions
git-wrangler rename-repo --description

Notes

  • Leave the prompt blank to skip renaming/updating a specific repository
  • Repositories that gh cannot identify as GitHub repositories are skipped
  • If secure keyring storage is unavailable, the command directs you to GIT_WRANGLER_GITHUB_TOKEN without exposing backend keyring errors