attic-sweep

Files (1)

• SKILL.md

SKILL.md (first lines)

# Sweep the session into the attic

First, in the same shell command as anything below, locate the script:

```bash
ATTIC_JS=$(ls -d "${CODEX_HOME:-$HOME/.codex}"/plugins/cache/attic/attic/*/skills/attic/scripts/attic.js "${CODEX_HOME:-$HOME/.codex}"/skills/attic/scripts/attic.js "$HOME"/.agents/skills/attic/scripts/attic.js .agents/skills/attic/scripts/attic.js 2>/dev/null | sort -V | tail -1)
```

Goal: after this runs, a fresh session that reads only `.attic/INDEX.md`
could continue the work.

Pipeline:

1. **Collect.** Review the conversation for anything not yet stashed:
   findings, decisions and why, the current plan and what is done, open
   questions, and in-progress state (files being edited, failing tests,
   commands to rerun).
2. **Dedupe.** Run the index and drop anything already covered. Append to an
   existing item where there is genuinely new detail.

```bash
node "$ATTIC_JS" index
```

3. **Write.** One stash per finding or decision, following `/attic-stash`.
   Then one session item, using `templates/session.md` as the shape:

```bash
node "$ATTIC_JS" stash \
  --slug session-$(date +%F) --kind plan --title "Session $(date +%F)" \
  --hook "<what this session is doing, one line>" --body-file <tmpfile>
```

4. **Verify.**

```bash
node "$ATTIC_JS" validate
```

   Fix anything it reports before finishing.
5. **Report.** List the handles written, one per line, then a single line:
   "Safe to /compact."

Copy commands, paths and errors verbatim. No secrets.

From NishikantaRay/Attic, MIT.

More from NishikantaRay/Attic