bborn/session-keeper/skill

Restore sessions after a reboot

session-snapshot runs every 10 minutes and records every tmux session, iTerm tab, and the exact Claude conversation open in each. session-restore brings back the ones you pick. Your job is to help pick.

Don't just restore everything. If they rebooted because a dozen agents had been open for weeks eating all their RAM, starting all of them again undoes the point. Nothing gets deleted either way, so anything skipped can still be resumed later.

Steps

1. Read the snapshot:

`` session-restore --json ``

Each entry has name, running, age, detail (where it used to be, and its title), and exact_id (false means it resumes by directory instead of a specific conversation).

1. Show a short table: name, age, what it was. Sort by age and point out the old ones — something open 3 hours is probably what they were doing, something open 22 days probably isn't. Don't overdo it, sometimes a long-running session is deliberate.

1. Suggest a set and ask. Anything with running: true is already back.

1. Restore what they pick:

`` session-restore --only name-one,name-two ``

--all exists, but prefer naming them so the transcript shows what happened.

1. Tell them to attach with tmux attach -t <name>. Dev servers (overmind start) aren't covered.

1. If taskyou.json in the snapshot dir lists any task-ui-* sessions, tell them which TaskYou UIs were open and give them the commands the restore printed — cd <dir> && ty --task <id>. Don't try to recreate those tmux sessions yourself; ty owns them.

Notes

• Restores are idempotent — existing sessions are skipped, so re-running is safe.
• needs_trust: true means that one comes up on Claude's "do you trust this folder?" prompt and waits. Tell them which ones, so they aren't left sitting there.
• exact_id: false means that one uses claude --continue, which reopens the most recent conversation in that directory. Fine if there was only one, worth mentioning if they seem to expect something specific.
• Older snapshots: session-restore --snapshot <dir> --list. The last 24 are kept.
• If there's no snapshot, say so rather than trying to rebuild it by hand.