Start Fresh

Run these steps in order. Stop and warn the user if any step has issues.

1. Check for uncommitted changes

git status --porcelain

If there are uncommitted changes, stop and ask the user what to do:

• •Stash them (git stash push -m "start-fresh auto-stash")
• •Discard them
• •Abort the fresh start

Do NOT silently discard work.

2. Switch to main and pull latest

git checkout main
git pull --ff-only origin main

If --ff-only fails, inform the user — their local main has diverged.

3. Clean up merged branches

List local branches that have been merged into main and delete them:

git branch --merged main | grep -v '^\*\|main$' | xargs -r git branch -d

Report which branches were deleted. If none, say so.

4. Check open todos

Use the todo tool to list open todos:

todo({ action: "list" })

Briefly summarize any open items so the user knows what's pending.

5. Clean up tmux sessions

Kill any tmux sessions on the pi socket:

SOCKET="${TMPDIR:-/tmp}/pi-tmux-sockets/pi.sock"
if [ -S "$SOCKET" ]; then
  tmux -S "$SOCKET" list-sessions -F '#{session_name}' 2>/dev/null | while read -r s; do
    tmux -S "$SOCKET" kill-session -t "$s" 2>/dev/null
  done
fi

Report how many sessions were killed. If none, say so.

6. Done

Tell the user the workspace is ready for a new task.