st0nefish/git-cli

git-cli

Use ${COPILOT_PLUGIN_ROOT}/scripts/git-cli to interact with the issue tracker and CI system for the current repository. Platform (GitHub or Gitea) is auto-detected from the git remote — no configuration needed.

When to use this skill

• File a bug or enhancement issue discovered mid-session
• Check open issues to understand what work is planned or in progress
• Post a progress comment on a linked issue
• Check CI run status or fetch logs for a failing build
• Inspect the current state of a pull request

Available commands

Issues

# List open issues (returns normalized JSON array)
${COPILOT_PLUGIN_ROOT}/scripts/git-cli issue list [--limit N] [--state open|closed|all] [--label LABEL] [--assignee USER]

# Show a single issue with full body and comments
${COPILOT_PLUGIN_ROOT}/scripts/git-cli issue show <number>

# Create an issue (pipe body to --body via heredoc)
${COPILOT_PLUGIN_ROOT}/scripts/git-cli issue create --title "Title" --body [--label bug] <<'EOF'
## Problem
...
EOF

# Add a comment (heredoc for multi-line, printf for short)
${COPILOT_PLUGIN_ROOT}/scripts/git-cli issue comment <number> --body <<'EOF'
Progress update...
EOF
printf 'LGTM' | ${COPILOT_PLUGIN_ROOT}/scripts/git-cli issue comment <number> --body

# Close or reopen
${COPILOT_PLUGIN_ROOT}/scripts/git-cli issue close <number>
${COPILOT_PLUGIN_ROOT}/scripts/git-cli issue reopen <number>

Pull Requests

# List PRs
${COPILOT_PLUGIN_ROOT}/scripts/git-cli pr list [--state open|closed|merged|all] [--limit N]

# Show a single PR with details
${COPILOT_PLUGIN_ROOT}/scripts/git-cli pr show <number>

# Create a PR (auto-assigns to current user)
${COPILOT_PLUGIN_ROOT}/scripts/git-cli pr create --title "Title" --head branch --base main --body <<'EOF'
## Summary
...

## Test plan
...
EOF

# Comment on a PR
${COPILOT_PLUGIN_ROOT}/scripts/git-cli pr comment <number> --body <<'EOF'
Review follow-up...
EOF

# Merge or close
${COPILOT_PLUGIN_ROOT}/scripts/git-cli pr merge <number> [--squash | --rebase]
${COPILOT_PLUGIN_ROOT}/scripts/git-cli pr close <number>

CI Runs

# List recent runs (JSON with id, status, workflow, branch, event, started_at)
${COPILOT_PLUGIN_ROOT}/scripts/git-cli run list [--limit N] [--status failure|success|pending] [--branch BRANCH]

# Show details of a specific run
${COPILOT_PLUGIN_ROOT}/scripts/git-cli run show <run-id>

# Fetch logs (--failed-only shows only failing steps on GitHub)
${COPILOT_PLUGIN_ROOT}/scripts/git-cli run logs <run-id>
${COPILOT_PLUGIN_ROOT}/scripts/git-cli run logs <run-id> --failed-only

Repo / User

${COPILOT_PLUGIN_ROOT}/scripts/git-cli repo default-branch   # e.g. "main" or "master"
${COPILOT_PLUGIN_ROOT}/scripts/git-cli repo info             # name, description, stars, etc.
${COPILOT_PLUGIN_ROOT}/scripts/git-cli user whoami           # {"login": "username"}

Output format

All commands return JSON. Issue and PR objects use a normalized schema:

{
  "number": 42,
  "title": "...",
  "body": "...",
  "state": "open",
  "author": "username",
  "labels": ["bug", "high-priority"],
  "milestone": null,
  "assignees": ["username"],
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z",
  "url": "https://..."
}

Writing issue/PR bodies

Pipe the body to --body via a heredoc. No temp file, no cleanup:

${COPILOT_PLUGIN_ROOT}/scripts/git-cli issue create --title "Bug: ..." --label bug --body <<'EOF'
## Problem
...

## Steps to reproduce
...
EOF

--body-file FILE remains available when the body is already on disk, and --body-file - is equivalent to --body (reads stdin). There is no --body TEXT form — stdin handles every size from one-liners to full PR descriptions.