| name | archive-session |
| description | Archive a stale session without loading its context — stamps its notes.md as "archived" in the Session history and removes it from active-sessions.json. The note file is kept on disk. Use for sessions that are done or abandoned. Trigger on "/archive-session <slug>", "archive session <slug>". |
| allowed-tools | Bash Read Edit |
| argument-hint | <session-slug> |
/archive-session <slug> — archive a stale session
Marks a session archived without loading its full context. Nothing is deleted —
the notes.md stays on disk and can be reopened later with /restart-session <slug>.
Usage: /archive-session my-feature or /archive-session PROJ-1234
Step 0 — Mode check
If plan mode is active (a Plan mode is active system reminder is present): stop and print:
⚠️ Plan mode is active — this skill writes files and will be blocked.
Switch to auto mode, then re-run /archive-session.
Step 1 — Resolve the slug
SLUG = the argument (trim whitespace). If empty, ask the user which session to
archive (the slug is the session's folder name, shown in the dashboard).
Step 2 — Locate the notes.md
Search every configured category base for <base>/<SLUG>/notes.md:
SLUG="<slug trimmed>"
matches=$(python3 ~/.claude/skills/lib/aoconfig.py find "$SLUG")
count=$(printf '%s' "$matches" | grep -c .)
- 0 → abort: "No notes.md found for
$SLUG. Check the slug in the dashboard."
- 1 →
NOTES_PATH="$matches"
- >1 → show the paths and ask which one.
Step 3 — Read it
Read $NOTES_PATH. From the frontmatter, note name, ticket, category.
Show a one-line summary before archiving:
Archiving: <name> [<ticket>] — <NOTES_PATH>
Step 4 — Stamp the Session history
Append a line under ## Session history (create the section if missing):
- <YYYY-MM-DD HH:MM> | ARCHIVED | archived via /archive-session
Use date +"%Y-%m-%d %H:%M" for the timestamp.
Step 5 — Remove from active-sessions.json
python3 - <<EOF
import json, os
p = os.path.expanduser('~/.claude/active-sessions.json')
if not os.path.exists(p):
print("active-sessions.json not found — nothing to remove"); raise SystemExit
data = json.load(open(p))
before = len(data)
data = {k: v for k, v in data.items() if v.get('notes_path') != '$NOTES_PATH'}
tmp = p + '.tmp'
json.dump(data, open(tmp, 'w'), indent=2); os.replace(tmp, p)
print(f"Removed {before - len(data)} entry(ies) from active-sessions.json")
EOF
Step 6 — Confirm
Print:
✓ Archived: <name> [<ticket>]
Stamped: <NOTES_PATH>
Removed from active sessions (note file kept).
Nothing was deleted — reopen any time with /restart-session <slug>.
