diff --git a/sys-apps-git-quick-reference.md b/sys-apps-git-quick-reference.md new file mode 100644 index 0000000..791c848 --- /dev/null +++ b/sys-apps-git-quick-reference.md @@ -0,0 +1,87 @@ +# 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