compozy session cleanup

Usage

Subcommands2

• statusShow the running or most recent archived-history cleanup
• stopStop the running archived-history cleanup; what it deleted stays deleted

Examples4

1. Preview what a cleanup of the current workspace would delete

   $compozy session cleanup

2. Delete every thread archived more than 30 days ago, across all workspaces

   $compozy session cleanup --older-than 30 --all-workspaces --yes

3. Keep main sessions; delete only their archived subagents

   $compozy session cleanup --subagents --any-time --yes

4. Follow or stop the running cleanup

   $Terminal

   compozy session cleanup status
   compozy session cleanup stop

Options11

--all-workspaces

Clean up every project and User scope

--any-time

Pick every archived thread, whenever it was archived

--beforestring

Pick threads archived before this date: YYYY-MM-DD (local midnight) or RFC 3339

--children

Delete archived child sessions, keeping main sessions

--everything

Delete picked threads whole: main sessions, child sessions, and subagents (the default)

--help-h

help for cleanup

--older-thanint

Pick threads archived more than this many days ago (default 7)

--sessionstrings

Limit the cleanup to these archived main sessions, as a retry of failed threads does

--subagents

Delete archived subagents, keeping main sessions

--workspacestring

Workspace ID, name, or path (defaults to the current workspace)

--yes

Delete; without it the command only previews

Inherited options3

--json

Emit JSON output

--output-ostring

Output format: human, json, jsonl, or toon (default "human")

--profilestring

Act as a profile for this command