Nap

Context compactor — prunes old sagaflow runs, archives stale memory files, compacts MEMORY.md indexes, compresses aimee journals. Like Squad's `squad nap` but for our Claude Code setup.

npow fa7df82 1.2 KB Updated

File contents

nap

Compact Claude Code context state to free disk and reduce token load.

Usage

When invoked, run the nap script:

python3 ~/code/npow-dotfiles/scripts/nap.py [flags]

Flags from user args

  • If the user says --dry-run or "dry run" or "what would it do": add --dry-run
  • If the user says --deep or "deep" or "aggressive": add --deep
  • If no flags specified: run with --dry-run first, show the report, then run for real

What it does

  1. PRUNE — deletes sagaflow run dirs older than 7 days (3 with --deep)
  2. COMPACT — removes dead pointers from MEMORY.md index files
  3. ARCHIVE — moves memory files not touched in 30 days (14 with --deep) to archive/ subdirs
  4. COMPRESS — archives old aimee journal entries (>7 days or >50KB; >3 days or >20KB with --deep)

Workflow

  1. Run with --dry-run first unless the user explicitly said to just do it
  2. Show the report output to the user
  3. If dry-run, ask once: "Run it for real?" — then execute without --dry-run
  4. Show the final report

npow/claude-skills/tree/main/nap commit fa7df82142

Frequently asked questions

npx skillmds@latest add npow/nap