Skip to main content
command CX Codex

speckit.git.remote — Claude Code command: what it does, install

speckit.git.remote detects the Git remote origin URL, parses repository ownership, and validates github.com hosts for downstream workflows.

MIT ★ 110 updated 2026-10-19

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/speckit.git.remote.md
Open on GitHub

What speckit.git.remote does

The command verifies the current directory with git rev-parse --is-inside-work-tree and pulls the origin address using git config --get remote.origin.url. From there, it isolates the repository owner and project name. It recognizes standard HTTPS strings (https://github.com/<owner>/<repo>.git) as well as SSH paths ([email protected]:<owner>/<repo>.git).

Non-GitHub remotes will not be flagged as GitHub targets. That distinction matters: automation tasks such as issue creation rely strictly on github.com endpoints. If Git is absent or no remote origin exists, the prompt returns an empty result instead of throwing a fatal error.

What it helps with

  • extract repository owner and name from remote origin URL
  • verify whether origin points directly to github.com
  • prepare repository parameters for GitHub issue automation
  • handle non-Git folders without breaking parent agent steps

Example prompts for the agent

  • Run speckit.git.remote to parse the remote URL of this project
  • Check with speckit.git.remote if the origin remote points to github.com
  • Execute speckit.git.remote and print the detected repository owner

How to install speckit.git.remote

Manually: put the files in place

.claude/commands/speckit.git.remote.md

Call it with /speckit.git.remote. For all projects use ~/.claude/commands/

Questions about speckit.git.remote

How to install speckit.git.remote in Claude Code?

Add the command file directly to your project under .claude/commands/speckit.git.remote.md.

What does speckit.git.remote do?

It reads the origin URL via Git, parses the owner and repo name, and checks if the remote points to GitHub.

Which Git remote formats are supported?

It handles HTTPS (https://github.com/<owner>/<repo>.git) and SSH formats ([email protected]:<owner>/<repo>.git).

Source text

speckit.git.remote.md · MIT
---
description: "Detect Git remote URL for GitHub integration"
---

# Detect Git Remote URL

Detect the Git remote URL for integration with GitHub services (e.g., issue creation).

## Prerequisites

- Check if Git is available by running `git rev-parse --is-inside-work-tree 2>/dev/null`
- If Git is not available, output a warning and return empty:
  ```
  [specify] Warning: Git repository not detected; cannot determine remote URL
  ```

## Execution

Run the following command to get the remote URL:

```bash
git config --get remote.origin.url
```

## Output

Parse the remote URL and determine:

1. **Repository owner**: Extract from the URL (e.g., `github` from `https://github.com/github/spec-kit.git`)
2. **Repository name**: Extract from the URL (e.g., `spec-kit` from `https://github.com/github/spec-kit.git`)
3. **Is GitHub**: Whether the remote points to a GitHub repository

Supported URL formats:
- HTTPS: `https://github.com/<owner>/<repo>.git`
- SSH: `[email protected]:<owner>/<repo>.git`

> [!CAUTION]
> ONLY report a GitHub repository if the remote URL actually points to github.com.
> Do NOT assume the remote is GitHub if the URL format doesn't match.

## Graceful Degradation

If Git is not installed, the directory is not a Git repository, or no remote is configured:
- Return an empty result
- Do NOT error — other workflows should continue without Git remote information

© alfredoperez · MIT · alfredoperez/speckit-companion

Similar slash commands

All slash commands for Git and GitHub →

From the same set83

The whole set →
speckit-companion The speckit-companion GitHub Copilot plugin displays Spec Kit progress for each project spec. Open its documents or start the next stage from the board beside the chat. ★ 110repo stars tasks Generates dependency-ordered tasks with estimates from a feature spec. Outputs a structured tasks.md file. CX Codex GP ChatGPT ★ 110repo stars specify The specify prompt turns a feature description and project context into a Markdown spec. Use it to define requirements before implementation. CX Codex GP ChatGPT ★ 110repo stars speckit.taskstoissues speckit.taskstoissues — a prompt that converts a task list into structured GitHub Issues with dependency ordering. Works with design artifacts and requires GitHub MCP server access. CX Codex GP ChatGPT ★ 110repo stars cleanup-reviewer cleanup-reviewer reviews a specified slice of a repository cleanup diff and reports findings only. Use it when the review should stay within named files. CX Codex ★ 110repo stars speckit.git.initialize The speckit.git.initialize command sets up a Git repository in your project and creates an initial commit if one doesn't exist. Use it when starting a new project or preparing a template. CX Codex +1 ★ 110repo stars speckit-git-remote speckit-git-remote detects the Git remote URL and verifies GitHub connectivity for tasks like issue creation in spec-kit workflows. Designed for repositories structured with a .specify/ directory. CX Codex +1 ★ 110repo stars speckit-git-initialize speckit-git-initialize creates a Git repository in the current project and makes its first commit. It fits spec-kit projects that need Git initialized. CX Codex +1 ★ 110repo stars

Project sponsors

Companies that keep this analytics open