sweep

Reclaim stale state from Aether worktrees, branches, and memory.

1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/iamacoffeepot/aether --skill sweep-iamacoffeepot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sweep
Source: https://github.com/iamacoffeepot/aether/tree/main/.agents/skills/sweep
Command: npx skills add https://github.com/iamacoffeepot/aether --skill sweep-iamacoffeepot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The sweep Skill addresses the issue of stale state accumulation in various Aether components, providing a methodical approach to reclaiming space and ensuring workflow integrity.

Core Features & Use Cases

  • State Reclamation: Identifies and removes stale state from worktrees, branches, memory, ADRs, and fat issues.
  • Confirmation Process: Ensures that destructive or state-changing actions are performed only after explicit user confirmation.
  • Safety Checks: Implements safety checks to prevent the removal of live, open, or ambiguous work items without confirmation.

Quick Start

Use the sweep skill to clean up stale state in the current branch by executing the command: sweep --confirm.

Frequently Asked Questions about sweep

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clean up stale state in Aether worktrees and branches?

To clean up stale state in Aether worktrees and branches, use the sweep skill to identify and remove accumulated stale data. It methodically reclaims space and ensures workflow integrity by targeting specific components during the state reclamation process.

What is stale state reclamation and when do I need it for workflow maintenance?

Stale state reclamation is the process of removing obsolete data from worktrees, branches, memory, ADRs, and fat issues. You need it for workflow maintenance when accumulated stale data begins to consume space and threaten workflow integrity within the Aether ecosystem.

How do I execute a state sweep safely without deleting live work items?

To execute a state sweep safely, the skill implements safety checks that prevent the removal of live, open, or ambiguous work items. It ensures destructive actions are performed only after explicit user confirmation is provided before execution.

Can I automate stale state cleanup or is confirmation required for every sweep?

Confirmation is required for destructive state-changing actions during a stale state cleanup. You can execute the command `sweep --confirm` to perform the cleanup, but the skill's safety checks enforce explicit approval to protect live and open work items.

What components does the Aether sweep skill target for state reclamation?

The Aether sweep skill targets worktrees, branches, memory, ADRs, and fat issues for state reclamation. It performs sweeps to clean up stale data across these specific components to ensure overall workflow integrity.