git-operations

---

name: git-operations description: Enforce git/gh CLI separation rule for version control operations license: MIT compatibility: opencode metadata: category: version-control workflow: git

Git/gh CLI Separation Rule

Core Principle: Use git CLI for local operations, gh CLI only for GitHub PR operations

When to use git CLI

• git add - Stage changes
• git commit - Create commits
• git checkout / git switch - Branch operations
• git push / git pull - Remote synchronization
• git status / git log - Status and history
• git merge / git rebase - Integration operations
• git diff - View changes

When to use gh CLI

• gh pr create - Create pull requests
• gh pr list - List pull requests
• gh pr view - View pull request details
• gh pr merge - Merge pull requests
• gh pr checkout - Checkout PR branch
• gh issue create / gh issue list - Issue operations

Enforcement Guidelines

1. Never use gh for: commits, staging, branching, pushing/pulling
2. Never use git for: PR creation, PR management, issue operations
3. Always prefer git for core version control operations
4. Use gh only for GitHub-specific web UI operations

Examples

✅ Correct:

Copygit add .
git commit -m "feat: add new feature"
git push origin feature-branch
gh pr create --title "Add new feature" --body "Description here"

❌ Incorrect:

Copygh repo clone owner/repo  # Use git clone instead
gh release create         # Use git tag + gh release create is fine

Validation

Before executing any git/gh command, verify:

• Is this a local operation? → Use git
• Is this a PR/web operation? → Use gh
• Am I unsure? → Default to git for core operations