workspace-git

Workspace Git

Git operations for SwarmWS. All commands run in the SwarmWS workspace root (~/.swarm-ai/SwarmWS/).

Quick Reference

Operations

Status & Diff

# Quick status
git status --short

# Full diff (unstaged)
git diff

# Staged changes
git diff --cached

# Diff for specific file
git diff -- path/to/file

# Stat summary (files changed, insertions, deletions)
git diff --stat

# Word-level diff (useful for markdown)
git diff --word-diff

Commit Workflow

When user asks to commit:

1. Review — git status --short + git diff --stat
2. Summarize — Describe what changed in plain language
3. Stage — git add <specific files> (never git add -A blindly)
4. Commit — Write a clear commit message

# Stage specific files
git add Knowledge/Notes/2026-03-15-plan.md .context/MEMORY.md

# Commit with descriptive message
git commit -m "$(cat <<'EOF'
Add explorer improvement plan and update memory

- Created comprehensive explorer improvement plan (Phase 1-4)
- Updated MEMORY.md with session decisions

Co-Authored-By: Swarm <[email protected]>
EOF
)"

Rules:

• Never use git add -A or git add . without reviewing first
• Never commit .env, credentials, or large binaries
• Always include Co-Authored-By when agent writes the commit
• Prefer specific file staging over wildcard
• Ask user before committing if changes are large or unclear

Log & History

# Recent commits
git log --oneline -10

# Commits with file changes
git log --oneline --name-only -5

# Commits by date range
git log --since="2026-03-14" --until="2026-03-15" --oneline

# Search commit messages
git log --all --grep="keyword" --oneline

# Search code changes (pickaxe)
git log -S "function_name" --oneline

# File history
git log --oneline -- path/to/file

# Graph view
git log --oneline --graph --all -20