/pause — Session Pause

/pause — Session Pause

Save-state operation. Commits any in-progress work and records session context so the next session can resume cleanly.

Invocation

/pds:pause                              # Auto-generate note from recent git log
/pds:pause "finished auth, next: tests" # Explicit note about where you left off

Protocol

1. Check Working Tree

git status --short

2. Commit Uncommitted Changes (if any)

If there are uncommitted changes (staged or unstaged):

git add <relevant files>   # Be deliberate — not -A
git commit -m "wip: pausing session $(date -u +%Y-%m-%dT%H:%M:%SZ)"

If the working tree is clean, skip — do not create an empty commit.

3. Save State to .claude/swarm/pause.json

Write the following JSON:

{
  "timestamp": "<ISO 8601>",
  "branch": "<current branch>",
  "phase": "<contents of .claude/swarm/phase, or 'none'>",
  "tier": "<contents of .claude/swarm/tier, or 'none'>",
  "uncommitted_files": <count before commit, 0 if clean>,
  "note": "<user-provided string, or summary from recent git log>"
}

Read .claude/swarm/phase and .claude/swarm/tier if they exist; use "none" if missing.

For auto-generated notes, use: git log --oneline -3 — summarize what was recently worked on.

4. Check for Active Swarm Agents

If .claude/swarm/phase exists and is not empty, print:

Note: a swarm may be active. Consider shutting down agents before closing the session.

Do not force-stop agents — just surface the suggestion.

5. Print Confirmation

Session paused. State saved to .claude/swarm/pause.json. Resume with /resume.

Rules

• Never create an empty commit on a clean working tree.
• Stage files deliberately — no git add -A.
• The pause.json write is the only required side effect on a clean tree.
• This is a save-state operation, not a workflow — keep it fast and simple.