| name | spectre-forget |
| description | Clear session memory - archive all session files so next session starts fresh |
| user-invocable | true |
| disable-model-invocation | true |
forget
Input Handling
Treat the current command arguments as this workflow's input. When invoked from a slash command, use the forwarded $ARGUMENTS value.
forget: Clear Session Memory
Description
- What — Archive all session files (handoffs, todos, history) so the SessionStart hook doesn't auto-resume
- Outcome — All session files moved to archive, user informed to start fresh session
Step (1/2) - Archive Session Logs
- Action — ArchiveLogs: Move active session files for the current branch into each root's archive directory
branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo unknown)
canonical_dir=".spectre/handoffs/${branch}"
legacy_dir="docs/tasks/${branch}/session_logs"
archived_count=0
for session_dir in "$canonical_dir" "$legacy_dir"; do
[ -d "$session_dir" ] || continue
archive_dir="${session_dir}/archive"
while IFS= read -r -d '' session_file; do
mkdir -p "$archive_dir"
mv "$session_file" "$archive_dir/"
archived_count=$((archived_count + 1))
done < <(
find "$session_dir" -maxdepth 1 -type f \
\( -name '*_handoff.json' -o -name '*_todos.json' -o -name 'todos_history.json' \) \
-print0
)
done
if [ "$archived_count" -eq 0 ]; then
echo "NO_SESSIONS"
exit 0
fi
echo "ARCHIVED:${archived_count}"
Archive only the current branch's active, top-level files in .spectre/handoffs/{branch}/ and the matching legacy docs/tasks/{branch}/session_logs/. Do not scan another branch, descend into an existing archive/, merge the roots, or restore an archived file. The raw branch name is used directly; slash-containing branches intentionally nest.
Step (2/2) - Confirm to User
-
Action — ConfirmCleared: Based on bash output, inform user
If output is NO_SESSIONS:
No session logs found for this branch. Memory is already clear.
Else (output is ARCHIVED:N):
✓ Session memory cleared
Archived {N} session file(s) under the matching .spectre/handoffs/{branch}/archive/ and legacy docs/tasks/{branch}/session_logs/archive/ directories.
Next: Start a new session with /clear or close this terminal. Your next session will start fresh without auto-loaded context.
Success Criteria
