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 Updated 5 repo stars

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 commit fa7df82142

Frequently asked questions

npx get-skill add npow/nap