github-passwordless-setup

# GitHub Passwordless Setup

Complete guide to setting up passwordless authentication for GitHub using SSH keys and Personal Access Tokens (PAT). Once configured, you'll never need to enter passwords for Git operations or GitHub CLI commands.

**Verified Working:**
- ✅ macOS 10.15+ (tested on 14.4)
- ✅ Linux (Ubuntu, Debian, Fedora, Arch)
- ✅ Windows (WSL2, Git Bash)

## 🎯 What This Solves

**Before:**
- ❌ Type password every time you push/pull
- ❌ GitHub CLI requires re-authentication
- ❌ Tokens expire and break workflows
- ❌ HTTPS URLs need credentials repeatedly

**After:**
- ✅ Zero-password Git operations (push/pull/clone)
- ✅ Zero-password repository creation
- ✅ Zero-password issue/PR management
- ✅ Persistent authentication (no expiration)

## 🚀 Quick Setup

One-line automated setup:

```bash
curl -fsSL https://raw.githubusercontent.com/happydog-intj/github-passwordless-setup/master/setup.sh | bash
```

Or follow the manual steps below.

## 📋 Manual Setup

### Part 1: SSH Key Configuration

SSH keys enable password-free Git operations (push/pull/clone).

#### Step 1: Check for Existing SSH Keys

```bash
ls -la ~/.ssh/*.pub
```

If you see `id_ed25519.pub` or `id_rsa.pub`, you already have a key. Skip to Step 3.

#### Step 2: Generate New SSH Key

**Recommended: ED25519 (most secure)**

```bash
ssh-keygen -t ed25519 -C "your-email@example.com"
```

**Or RSA (if ED25519 not supported):**

```bash
ssh-keygen -t rsa -b 4096 -C "your-email@example.com"
```

**During generation:**
- Press Enter for default location (`~/.ssh/id_ed25519`)
- Enter passphrase (optional but recommended)
- macOS will save passphrase to Keychain

#### Step 3: Copy Public Key

```bash
# macOS
cat ~/.ssh/id_ed25519.pub | pbcopy

# Linux (xclip)
cat ~/.ssh/id_ed25519.pub | xclip -selection clipboard

# Linux (xsel)
cat ~/.ssh/id_ed25519.pub | xsel --clipboard

# Or just display and copy manually
cat ~/.ssh/id_ed25519.pub
```

#### Step 4: Add Key to GitHub

1. Visit: https://gi...

# GitHub Passwordless Setup

**Never type passwords again for Git operations and GitHub API calls!**

[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-macOS%20|%20Linux%20|%20Windows-blue.svg)]()

English | [简体中文](README.zh-CN.md)

## 🎯 What This Does

Configures **complete passwordless authentication** for GitHub using:
1. **SSH Keys** - Zero-password Git operations (push/pull/clone)
2. **Personal Access Token** - Zero-password repository management

**One-time setup, lifetime convenience!**

## ⚡ Quick Start

```bash
curl -fsSL https://raw.githubusercontent.com/happydog-intj/github-passwordless-setup/master/setup.sh | bash
```

## ✨ Before vs After

| Operation | Before | After |
|-----------|--------|-------|
| `git push` | ❌ Password required | ✅ Instant |
| `git clone` | ❌ Password required | ✅ Instant |
| `gh repo create` | ❌ Re-authentication | ✅ Instant |
| Token expiration | ❌ Breaks workflow | ✅ Never expires* |

*with "No expiration" token setting

## 📋 What You Get

### SSH Key Authentication
- ✅ Push code without passwords
- ✅ Pull updates instantly
- ✅ Clone repos seamlessly
- ✅ Works with all Git operations

### GitHub CLI (gh) with PAT
- ✅ Create repositories: `gh repo create`
- ✅ Manage issues: `gh issue create/list`
- ✅ Handle PRs: `gh pr create/merge`
- ✅ All GitHub operations

## 🚀 Manual Setup (5 minutes)

### Part 1: SSH Key (3 minutes)

```bash
# 1. Generate key (if you don't have one)
ssh-keygen -t ed25519 -C "your-email@example.com"

# 2. Copy public key
cat ~/.ssh/id_ed25519.pub | pbcopy  # macOS
cat ~/.ssh/id_ed25519.pub           # Linux (copy manually)

# 3. Add to GitHub
# Visit: https://github.com/settings/ssh/new
# Paste key and save

# 4. Test
ssh -T git@github.com
```

### Part 2: GitHub CLI Token (2 minutes)

```bash
# 1. Create token
# Visit: https://github.com/settings/tokens/new
# Scopes: ✅ repo (select all)
# Click "Generate to...