# Git Basics - Quick Reference

Simple commands you'll use all the time.

---

## Daily Workflow

### Check what changed
```bash
git status              # See what files changed
git diff                # See exact changes
```

### Save your work
```bash
git add -A                    # Stage ALL changes (new, modified, deleted)
git commit -m "your message"  # Save with description
git push origin main          # Upload to Gitea
```

### Get latest changes
```bash
git pull origin main    # Download updates from Gitea
```

---

## What Each Command Does

| Command | What it does |
|---------|-------------|
| `git add -A` | Mark all changes as ready to save |
| `git commit -m "msg"` | Save marked changes with a description |
| `git push origin main` | Upload commits to Gitea |
| `git pull origin main` | Download latest from Gitea |
| `git status` | Show what changed |
| `git diff` | Show exact line changes |

---

## Common Patterns

### Made changes, want to save and upload:
```bash
git add -A
git commit -m "Add health checks to services"
git push origin main
```

### Want to see what you changed before committing:
```bash
git status              # See which files changed
git diff                # See exact changes
git add -A              # Stage everything
git commit -m "..."     # Commit
git push                # Push
```

### Get updates from Gitea:
```bash
git pull origin main
```

---

## Remember

- **git add** = Mark files (staging)
- **git commit** = Save with message (local)
- **git push** = Upload to Gitea (remote)
- **-A** = ALL files (new, modified, deleted)
- **-m** = Message (inline, no editor)

---

## When to Use Finish-Up Agent vs Manual Git

**Use finish-up agent:**
- Ending work session
- Want comprehensive documentation
- Need session summary

**Use manual git:**
- Quick commits during work
- Custom commit messages
- Frequent small saves