AReaL: Command for Claude Code

Create Pull Request

Rebase from the latest origin/main, squash commits, and create a PR on GitHub with an intelligent title and description.

Usage

/create-pr [--draft] [--base <branch>]

Arguments:

• --draft: Create as draft PR
• --base <branch>: Target branch (default: main)

Workflow

Step 1: Verify Prerequisites

# Check current branch
git branch --show-current

# Check if on main/master (should NOT be)
if [[ $(git branch --show-current) == "main" || $(git branch --show-current) == "master" ]]; then
  echo "ERROR: Cannot create PR from main/master branch"
  exit 1
fi

# Check for uncommitted changes
git status --short

# Ensure gh CLI is available
gh --version

Action: If there are uncommitted changes, stop, and then ask user to commit or stash them first.

Step 1.5: Determine Push Remote (Fork Support)

Check if user has push access to origin, and if not, identify the fork remote.

# List all remotes
git remote -v

# Try to determine push remote
# Option 1: Check if origin is writable (try a dry-run push)
git push --dry-run origin $(git branch --show-current) 2>&1

# Option 2: Check gh auth status and repo permissions
gh auth status
gh repo view --json owner,name,viewerPermission

Logic for Determining Push Remote:

If origin is writable: Use origin directly (maintainer workflow)

If origin is NOT writable: Look for a fork remote

• Common fork remote names: fork, user, <username>, or any remote pointing to user's fork
• Verify the fork remote points to user's own fork via gh repo view <remote-url> --json owner

If no fork remote found: Ask user to add their fork as a remote:

git remote add fork https://github.com/<username>/AReaL.git

Store for later use:

• PUSH_REMOTE: The remote to push to (e.g., origin or fork)
• UPSTREAM_REPO: The upstream repo for PR target (e.g., areal-project/AReaL)
• FORK_OWNER: Fork owner username (for --head parameter if needed)