Compact Issues

Reduce database size by summarizing closed issues no longer actively referenced.

Compaction Tiers

• Tier 1: Semantic compression (30+ days closed, ~70% size reduction)
• Tier 2: Ultra compression (90+ days closed, ~95% size reduction)

Usage

• Preview candidates: beads compact --dry-run
• Compact all eligible: beads compact --all
• Compact specific issue: beads compact --id beads-42
• Force compact: beads compact --id beads-42 --force (bypass age checks)
• View statistics: beads compact --stats

Options

• --tier: Choose compaction tier (1 or 2, default: 1)
• --workers: Parallel workers (default: 5)
• --batch-size: Issues per batch (default: 10)

Important

This is permanent graceful decay - original content is discarded. Use beads restore <id> to view full history from git if needed.

Useful for long-running projects to keep database size manageable.