nap

Compresses agent histories, prunes logs, and archives stale .squad state files.

2|Updated Jul 24, 2026

Search Tags:#multi-agent #maintenance #compression #archiving #agent history #state cleanup #context hygiene

Ready to run

npx skills add https://github.com/elbruno/ElBruno.MagenticUI --skill nap-elbruno

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: nap
Source: https://github.com/elbruno/ElBruno.MagenticUI/tree/main/.squad/templates/skills/nap
Command: npx skills add https://github.com/elbruno/ElBruno.MagenticUI --skill nap-elbruno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-running multi-agent sessions accumulate large history files, stale decisions, and orphaned inbox files that consume context window budget and slow down agent workflows. ## Core Features & Use Cases - History Compression: Compresses agent history.md files that exceed 15KB to reclaim context budget. - State Archival: Archives stale decisions and cleans orphaned inbox files in the .squad/ directory. - Dry-Run and Deep Modes: Preview changes with --dry-run or perform thorough cleanup with --deep. - Use Case: Before spawning many agents for a fan-out task, run a cleanup pass to free context window space and keep the .squad/ directory under 1MB. ## Quick Start Run the nap skill in dry-run mode to preview which .squad state files would be compressed, pruned, or archived.

Frequently Asked Questions about nap

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

FAQPage Schema

How do I clean up .squad state files?▼

Run squad nap from the CLI or /nap from the REPL to compress agent histories, prune old logs, and archive stale decisions. Use the --dry-run flag first to preview what will change before applying cleanup.

When should I run context hygiene on agent state?▼

Run it before heavy fan-out work where many agents will spawn, when history.md files exceed 15KB, when the .squad directory exceeds 1MB, or after long-running sessions and sprints.

What is the difference between nap and nap --deep?▼

The standard nap command performs routine compression, pruning, and archiving of .squad state. The --deep flag triggers a more thorough cleanup pass for heavily accumulated state.

Can I preview nap cleanup without deleting anything?▼

Yes, use squad nap --dry-run or /nap --dry-run to preview which files would be compressed, pruned, or archived without making any changes to the .squad directory.

Does nap delete agent decision records permanently?▼

Nap archives stale decisions rather than permanently discarding them, and cleans orphaned inbox files. Running with --dry-run first lets you confirm exactly what will be affected.