ktg-plugin-marketplace/plugins/config-audit/commands/cleanup.md

name	description	allowed-tools	model
config-audit:cleanup	Clean up old config-audit sessions to reclaim disk space	Read, Write, Glob, Bash, AskUserQuestion	sonnet

Config-Audit: Session Cleanup

Manage and clean up accumulated config-audit sessions in ~/.claude/config-audit/sessions/.

Usage

/config-audit cleanup

Implementation Steps

1. List all sessions:

   • Glob ~/.claude/config-audit/sessions/*/state.yaml
   • For each session, read state.yaml and extract:
     • Session ID
     • Created timestamp
     • Current phase
     • Whether session is active (has next_phase and current_phase is not verify or complete)

2. Calculate disk usage:

   • Use du -sh ~/.claude/config-audit/sessions/{session-id}/ for each session
   • Calculate total usage

3. Display session table:

   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   Config-Audit Sessions
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   
   | # | Session ID | Age | Phase | Status | Size |
   |---|------------|-----|-------|--------|------|
   | 1 | 20260127_102527 | 15d | implement | active | 12K |
   | 2 | quick-20260126 | 16d | analyze | complete | 8K |
   | 3 | 20260120_091500 | 22d | analyze | complete | 6K |
   
   Total: 3 sessions, 26K disk usage
   

4. Ask cleanup action:

   AskUserQuestion:
     question: "Which sessions should I clean up?"
     header: "Cleanup"
     options:
       - label: "Completed sessions only (Recommended)"
         description: "Delete sessions where phase is verify/complete. Keeps active sessions safe."
       - label: "Older than 14 days"
         description: "Delete all sessions older than 14 days, regardless of status."
       - label: "All except current"
         description: "Delete everything except the most recent active session."
       - label: "Cancel"
         description: "Don't delete anything."
   

5. Safety guards:

   • NEVER delete sessions where current_phase is not verify or complete AND next_phase exists, unless user explicitly chose age-based or all-except-current
   • Warn before deleting active sessions: "Session {id} is still active (phase: {phase}). Delete anyway?"

6. Execute cleanup:

   • For each session to delete: rm -rf ~/.claude/config-audit/sessions/{session-id}/
   • Track deleted count and freed space

7. Output summary:

   ✓ Cleanup complete
   
   Deleted: 2 sessions
   Freed: 14K disk space
   Remaining: 1 session (active)
   

Session Status Detection

A session is considered active if ALL of these are true:

• current_phase is not verify and not complete
• next_phase exists and is not empty

A session is considered complete if ANY of these are true:

• current_phase is verify or complete
• next_phase is empty or null

Error Handling

• Legacy path: Also check ~/.config-audit/sessions/ for sessions created before v2.2.0. If found, include them in the session list and note: "Found {n} session(s) at legacy path (~/.config-audit/). These will be cleaned up normally."
• If ~/.claude/config-audit/sessions/ doesn't exist (and no legacy sessions): "No sessions found. Nothing to clean up."
• If no sessions match criteria: "No sessions match the selected criteria."
• If deletion fails: Log error, continue with other sessions