GitHub Complete Master Manual

// Verify Git installation git --version git --help // Verify GitHub CLI installation gh --version // Authenticate GitHub CLI with browser/token gh auth login gh auth status

git config --global user.name "Your Name" git config --global user.email "you@example.com" git config --global init.defaultBranch main // Inspect active configuration git config --global --list git config --list --show-origin // Recommended optional settings git config --global core.autocrlf true git config --global fetch.prune true git config --global pull.rebase false

// SSH Key Generation (ed25519) ssh-keygen -t ed25519 -C "you@example.com" // Add ~/.ssh/id_ed25519.pub to GitHub Account Settings -> SSH Keys // Test SSH Connection ssh -T git@github.com

// Clone existing remote repo git clone git@github.com:USERNAME/REPO.git cd REPO git remote -v git status // Initialize local repo and connect to GitHub remote mkdir my-project cd my-project git init git branch -M main git remote add origin git@github.com:USERNAME/my-project.git

git status git diff git add . git diff --cached git commit -m "feat: add user registration" // Stage specific file git add app.py // Stage selected interactive chunks (patch mode) git add -p

git log --oneline --graph --decorate --all git show HEAD git show HEAD~1 git log --since="2 weeks ago" git log --author="Name" git log -- path/to/file.py

git branch git branch -a git switch -c feature/login git switch main git branch -m feature/login feature/user-login git branch -d feature/user-login // Push new branch to remote git push -u origin feature/user-login git push origin --delete feature/user-login

git switch main git pull --ff-only git merge feature/user-login // Abort conflicted merge git merge --abort

git status git diff // Resolution Steps: // 1. Manually edit file to remove conflict markers and select clean code // 2. Stage resolved file: git add app.py git commit -m "fix: resolve merge conflict in app.py" // Cancel merge if needed: git merge --abort

git fetch origin git switch feature/login git rebase origin/main // Interactive Rebase (Clean last 5 commits) git rebase -i HEAD~5

git restore app.py git restore --staged app.py git revert abc1234 git reset --soft HEAD~1 git reset HEAD~1 git reset --hard HEAD~1

git reflog git reflog show main // Recover lost commit by creating a new branch at lost SHA git switch -c recovery_branch abc1234 git show abc1234

git stash push -m "WIP login form" git stash list git stash show -p stash@{0} git stash apply stash@{0} git stash pop git stash drop stash@{0} git stash clear

git remote -v git remote show origin git fetch origin git fetch --prune origin git pull git pull --rebase git pull --ff-only git push -u origin feature/login git push --force-with-lease

git tag git tag -a v1.0.0 -m "Release version 1.0.0" git show v1.0.0 git push origin v1.0.0 git push origin --tags // Delete tag git tag -d v1.0.0 git push origin --delete v1.0.0

// Cherry pick git cherry-pick abc1234 // Bisect binary search git bisect start git bisect bad git bisect good v1.0.0 // test project git bisect good // or git bisect bad git bisect reset // Worktree git worktree add ../hotfix hotfix/payment git worktree list git worktree remove ../hotfix

// Add Git Submodule git submodule add https://github.com/org/shared-lib.git libs/shared-lib git submodule update --init --recursive // Configure Git Large File Storage (LFS) git lfs install git lfs track "*.psd" git add .gitattributes design.psd git commit -m "chore: track design asset with LFS"

git switch -c feature/profile // make changes & test git add . git commit -m "feat: add profile endpoint" git push -u origin feature/profile // Open GitHub PR: base: main <- compare: feature/profile

git clone https://github.com/YOU/project.git git remote add upstream https://github.com/OWNER/project.git git fetch upstream git switch main git merge upstream/main git switch -c fix/bug git push -u origin fix/bug

// .github/CODEOWNERS syntax example /api/ @backend-team /frontend/ @frontend-team /docs/ @docs-team /.github/workflows/ @devops-team

name: CI on: push: branches: [main] pull_request: permissions: contents: read jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v5 - run: echo "Run tests here"

on: push: branches: [main] pull_request: branches: [main] workflow_dispatch: schedule: - cron: "0 2 * * 1" release: types: [published]

// Useful Context Expressions: ${{ github.ref }} ${{ github.sha }} ${{ github.actor }} ${{ github.repository }} ${{ github.event_name }} ${{ runner.os }} ${{ matrix.node }} ${{ secrets.DEPLOY_KEY }} ${{ vars.APP_ENV }} ${{ needs.build.outputs.version }}

jobs: test: strategy: fail-fast: false matrix: node: ["20", "22"] os: [ubuntu-latest, windows-latest] runs-on: ${{ matrix.os }} steps: - uses: actions/checkout@v5 - uses: actions/setup-node@v5 with: node-version: ${{ matrix.node }} - run: npm ci - run: npm test

// Upload Artifact - name: Upload Build Artifact uses: actions/upload-artifact@v4 with: name: build-dist path: dist/ // Download Artifact - name: Download Build Artifact uses: actions/download-artifact@v4 with: name: build-dist path: dist/

jobs: test: runs-on: ubuntu-latest services: postgres: image: postgres:16 env: POSTGRES_PASSWORD: postgres ports: - 5432:5432 options: >- --health-cmd "pg_isready -U postgres" --health-interval 10s --health-timeout 5s --health-retries 5 steps: - uses: actions/checkout@v5 - run: pytest -q

// .github/workflows/reusable-ci.yml name: Reusable CI on: workflow_call: inputs: python: required: true type: string jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v5 - uses: actions/setup-python@v6 with: python-version: ${{ inputs.python }} - run: pytest -q // Caller Workflow: jobs: ci: uses: OWNER/REPO/.github/workflows/reusable-ci.yml@v1 with: python: "3.13"

// .github/actions/setup-project/action.yml name: Setup Project description: Common project setup inputs: version: required: true runs: using: composite steps: - uses: actions/setup-python@v6 with: python-version: ${{ inputs.version }} - shell: bash run: pip install -r requirements.txt

permissions: contents: read jobs: build: permissions: contents: read steps: - uses: actions/checkout@v5

jobs: deploy: runs-on: ubuntu-latest environment: production steps: - uses: actions/checkout@v5 - run: ./scripts/deploy.sh

// .github/dependabot.yml configuration version: 2 updates: - package-ecosystem: "pip" directory: "/" schedule: interval: "weekly" - package-ecosystem: "npm" directory: "/frontend" schedule: interval: "weekly" - package-ecosystem: "github-actions" directory: "/" schedule: interval: "weekly"

git switch main git pull --ff-only git tag -a v1.0.0 -m "Release 1.0.0" git push origin v1.0.0 // Create release via GitHub CLI with auto notes gh release create v1.0.0 --generate-notes

gh auth login gh repo clone OWNER/REPO gh issue create gh issue list gh pr create gh pr list gh pr checkout 123 gh pr review 123 --approve gh pr merge 123 gh run list gh run watch

// REST API Example via curl curl -L -H "Accept: application/vnd.github+json" -H "Authorization: Bearer $GITHUB_TOKEN" -H "X-GitHub-Api-Version: 2022-11-28" https://api.github.com/repos/OWNER/REPO // GraphQL Query Example query { repository(owner: "OWNER", name: "REPO") { name description stargazerCount } }

// .git/hooks/pre-commit executable shell script // bin/sh ruff check . pytest -q

git rev-parse HEAD git cat-file -t HEAD git cat-file -p HEAD git count-objects -v git fsck --full

// .devcontainer/devcontainer.json { "name": "Project Dev Environment", "image": "mcr.microsoft.com/devcontainers/python:3.13", "postCreateCommand": "pip install -r requirements.txt" }

// DAILY WORKFLOW git status git switch main git pull --ff-only git switch -c feature/name git diff git add . git commit -m "feat: description" git push -u origin feature/name // UNDO & RECOVERY git restore file git restore --staged file git revert SHA git reset --soft HEAD~1 git reset --hard HEAD~1 git reflog // GITHUB CLI gh auth status gh repo clone OWNER/REPO gh issue list gh pr create gh pr checkout 123 gh pr review 123 --approve