ctx-compact

name	ctx-compact
description	Archive completed tasks and trim context. Use when context files are growing large.

Archive completed tasks and trim stale context entries to keep the context directory lean and within token budgets.

When to Use

• When TASKS.md has many completed items
• When context token count is growing large
• When asked to "clean up" or "compact" context
• Before starting a new phase of work

When NOT to Use

• When all tasks are still active
• When context is already compact

Execution

Run the compact operation:

ctx compact

This archives completed tasks from TASKS.md into the session history and trims stale entries from other context files.

After running, confirm:

• How many tasks were archived
• Current token budget usage
• Whether any manual cleanup is recommended