shutdown

Writes verified session handoff files and memory pointers before terminal restarts.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/line7works/tony-skills --skill shutdown-line7works
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shutdown
Source: https://github.com/line7works/tony-skills/tree/main/plugins/shutdown/skills/shutdown
Command: npx skills add https://github.com/line7works/tony-skills --skill shutdown-line7works

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a Claude Code session ends — a terminal restart, an account switch, or quitting for the day — all uncommitted context, decisions, and in-flight work vanish unless someone writes it down. This Skill settles a session by verifying git state read-only, writing a self-contained handoff file, and leaving a memory pointer so the next session resumes with zero lost context. ## Core Features & Use Cases - Verified state capture: Runs git status, branch, log, worktree, and stash checks against the filesystem rather than trusting session memory, and reports dirty trees honestly without ever committing or cleaning anything. - Fixed-format handoff files: Writes a structured handoff to ~/Documents/handoffs/ with authorization state, decisions, verified traps, background work, and a negative test the resuming session must pass. - Multi-session sweep: The "/shutdown all" mode broadcasts a settle request to every open interactive terminal on the machine, collects replies with a deadline, and reports each session's outcome. - Use Case: Before restarting Terminal with three repos mid-work, invoke the skill to get one handoff file per session plus a paste-back line that drops the next session straight into the verified state. ## Quick Start Say "/shutdown" before restarting Terminal to write a verified handoff file and memory pointer for this session.

Frequently Asked Questions about shutdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I hand off a Claude Code session before restarting Terminal?

Invoke the shutdown skill, which verifies git state read-only, writes a fixed-format handoff file to ~/Documents/handoffs/, and saves a memory pointer. The next session resumes by reading that handoff file.

How do I settle multiple open terminal sessions at once?

Use "/shutdown all" in one session, which broadcasts a settle message to every interactive terminal on the same machine, collects replies with a timed deadline, and reports each session's handoff filename or status.

Does the shutdown skill commit or clean up my git changes?

No, the skill is strictly read-only toward every repo. It reports dirty trees, in-progress merges, and stashes honestly in the handoff but never commits, stages, stashes, or prunes anything.

What happens if a session has nothing to hand off?

If there is no repo work, no meaningful file work, no decisions, and no background tasks, the skill writes no file and simply reports "nothing to hand off", either in chat or as a reply to a sweep.

When should I not use the shutdown skill?

Do not use it for cross-machine handoffs between two Macs, which use a separate relay protocol, or for shutting down servers, crons, or retiring projects. It only settles sessions on the current machine.