ultrawork-clean

Ultrawork Clean Command

Overview

Clean ultrawork sessions. Two modes:

1. Single session clean (default): Delete current session for fresh /ultrawork start
2. Batch cleanup: Delete multiple sessions based on criteria (requires explicit flags)

---

Step 1: Parse Arguments

Parse command arguments to determine cleanup mode:

Argument	Mode	Behavior
(no args)	Single session	Delete ONLY current session (CLAUDE_SESSION_ID)
--older-than N	Batch	Delete terminal-state sessions older than N days
--completed	Batch	Delete all terminal-state sessions
--all	Batch	Delete ALL sessions (dangerous!)

IMPORTANT: Without batch flags (--all, --completed, --older-than), ONLY the current session is deleted.

---

Step 2: Execute Cleanup

Default Mode (No Arguments) - Single Session Clean

This is the DEFAULT behavior when /ultrawork-clean is run without arguments.

Deletes ONLY the current session (identified by CLAUDE_SESSION_ID) to allow a fresh /ultrawork start.

SCRIPTS="${CLAUDE_PLUGIN_ROOT}/src/scripts"

bun "${SCRIPTS}/ultrawork-clean.js" --session "${CLAUDE_SESSION_ID}"

Output:

{
  "success": true,
  "session_id": "abc-123",
  "goal": "Add user auth",
  "phase": "PLANNING",
  "message": "Session deleted. Run /ultrawork to start fresh."
}

Batch Mode: --older-than N

Delete sessions older than N days in terminal states only (COMPLETE, CANCELLED, FAILED).

SCRIPTS="${CLAUDE_PLUGIN_ROOT}/src/scripts"

bun "${SCRIPTS}/ultrawork-clean.js" --older-than ${N}

Batch Mode: --completed

Delete all sessions in terminal states, regardless of age.

SCRIPTS="${CLAUDE_PLUGIN_ROOT}/src/scripts"

bun "${SCRIPTS}/ultrawork-clean.js" --completed

Batch Mode: --all

Delete ALL sessions, including active ones. Use with extreme caution.

SCRIPTS="${CLAUDE_PLUGIN_ROOT}/src/scripts"

bun "${SCRIPTS}/ultrawork-clean.js" --all