git-repo-detection

Git Repository Detection

When to Use This Skill

Use this skill when...	Use the alternative when...
Extracting owner/repo from a git remote (HTTPS or SSH URL) for gh calls	Use gh-cli-agentic once you already have the owner/repo identifier
Handling GitHub Enterprise host URLs alongside github.com	Use git-fork-workflow when the question is fork vs upstream identification
Resolving the repo identifier to pass with gh -R to avoid remote-required errors	Use git-cli-agentic for raw git remote -v parsing if you need URL details
Detecting which repo a script is running inside before issuing API calls	Use git-coworker-check to detect concurrent agents in the same checkout

Expert knowledge for detecting and extracting GitHub repository information from git remotes, including repository name, owner, and full identifiers.

Core Expertise

Repository Identification

• Extract owner and repository name from git remotes
• Parse GitHub URLs (HTTPS and SSH)
• Handle GitHub Enterprise URLs
• Format as owner/repo for CLI/API usage

URL Parsing

• Parse HTTPS URLs: https://github.com/owner/repo.git
• Parse SSH URLs: git@github.com:owner/repo.git
• Handle custom domains: https://github.enterprise.com/owner/repo.git
• Clean .git suffix and extra paths

Essential Commands

Get Remote URLs

# List all remotes
git remote -v

# Get origin URL
git remote get-url origin

# Get specific remote
git remote get-url upstream

# Show remote details
git remote show origin

Extract Repository Name

# From HTTPS URL
git remote get-url origin | sed 's/.*\/\([^/]*\)\.git/\1/'

# From SSH URL
git remote get-url origin | sed 's/.*:\([^/]*\/[^/]*\)\.git/\1/' | cut -d'/' -f2

# From any URL (owner/repo format)
git remote get-url origin | sed 's/.*[:/]\([^/]*\/[^/]*\)\.git/\1/'

# Just repository name (no owner)
basename $(git remote get-url origin) .git

Extract Owner

# From any URL
git remote get-url origin | sed 's/.*[:/]\([^/]*\)\/[^/]*\.git/\1/'

# Alternative with awk
git remote get-url origin | awk -F '[:/]' '{print $(NF-1)}'

Get Full Identifier (owner/repo)

# Standard format for GitHub CLI/API
git remote get-url origin | sed 's/.*[:/]\([^/]*\/[^/]*\)\.git/\1/'

# With validation
REPO=$(git remote get-url origin 2>/dev/null | sed 's/.*[:/]\([^/]*\/[^/]*\)\.git/\1/')
echo "${REPO:-Unknown}"

# Store in variable
REPO_FULL=$(git remote get-url origin | sed 's/.*[:/]\([^/]*\/[^/]*\)\.git/\1/')
echo "Repository: $REPO_FULL"

URL Format Examples

HTTPS URLs

# Standard GitHub
https://github.com/owner/repo.git
# Extract: owner/repo

# Without .git suffix
https://github.com/owner/repo
# Extract: owner/repo

# GitHub Enterprise
https://github.company.com/owner/repo.git
# Extract: owner/repo

SSH URLs

# Standard SSH
git@github.com:owner/repo.git
# Extract: owner/repo

# Custom SSH port
ssh://git@github.com:443/owner/repo.git
# Extract: owner/repo

# Enterprise SSH
git@github.company.com:owner/repo.git
# Extract: owner/repo

Parsing Patterns

Universal Parser (HTTPS or SSH)

# Works for both HTTPS and SSH
parse_repo() {
  local url="$1"
  # Remove .git suffix
  url="${url%.git}"
  # Extract owner/repo
  if [[ "$url" =~ github\.com[:/]([^/]+/[^/]+) ]]; then
    echo "${BASH_REMATCH[1]}"
  elif [[ "$url" =~ :([^/]+/[^/]+)$ ]]; then
    echo "${BASH_REMATCH[1]}"
  fi
}

REPO=$(parse_repo "$(git remote get-url origin)")
echo "$REPO"

Robust Extraction with sed

# Handle both HTTPS and SSH, with or without .git
git remote get-url origin \
  | sed -E 's#.*github\.com[:/]##; s#\.git$##'

Using awk

# Split by : or / and get last two components
git remote get-url origin \
  | awk -F'[/:]' '{print $(NF-1)"/"$NF}' \
  | sed 's/\.git$//'

Real-World Usage

With GitHub CLI

# Get repo identifier for gh commands
REPO=$(git remote get-url origin | sed 's/.*[:/]\([^/]*\/[^/]*\)\.git/\1/')

# Use with gh
gh repo view "$REPO"
gh issue list --repo "$REPO"
gh pr list --repo "$REPO"

# Or use current directory (gh auto-detects)
gh repo view

For API usage, multiple remotes, scripts, aliases, and integration examples, see REFERENCE.md.

Edge Cases

Case	Check
No remote	git remote get-url origin &>/dev/null
Non-GitHub	git remote get-url origin | grep -q github.com
Multiple remotes	Use git remote get-url upstream for fork source
Submodule	git -C "$(git rev-parse --show-toplevel)" remote get-url origin

Quick Reference

Purpose	Command
Full identifier (owner/repo)	git remote get-url origin | sed 's/.*[:/]\([^/]*\/[^/]*\)\.git/\1/'
Owner only	git remote get-url origin | sed 's/.*[:/]\([^/]*\)\/[^/]*\.git/\1/'
Name only	basename $(git remote get-url origin) .git
Is GitHub?	git remote get-url origin | grep -q github.com
Validate in git repo	git rev-parse --git-dir &>/dev/null
List remotes	git remote -v
Set origin	git remote set-url origin git@github.com:owner/repo.git

Troubleshooting

Problem	Fix
Remote not found	git remote add origin git@github.com:owner/repo.git
Wrong remote	git remote set-url origin <correct-url>
Parse failure	Check raw URL: git remote get-url origin

Related Skills

• github MCP - Use extracted repo name with GitHub API
• github-actions-inspection - Pass repo to gh CLI commands
• git-workflow - Identify repo for workflow operations