nsheaps/restart
plugins/agentic-behavior/skills/restart/SKILL.md
Restart the Claude Code session by gracefully exiting so the launcher loop restarts it. Use when you need to pick up config changes, plugin updates, or env var changes. Requires a launcher script (e.g., run-agent.sh) that restarts Claude after exit.
$ install --global
skillsauthnpx skillsauth add nsheaps/ai-mktpl restartInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 6, 2026, 7:09 AM303.5s1 file scanned
SKILL.md
- name:
- restart
- description:
- |
Restart
This skill enables Claude to restart its own session by performing a graceful exit (SIGINT), relying on the launcher script to restart the process.
When to Use This Skill
- After making configuration changes that require a restart (plugin updates, settings changes)
- After environment variable changes that only take effect on session start
- When the handler requests a restart
- When you need a fresh session to pick up new hooks or rules
How It Works
Restart is simply an exit with the expectation that a launcher script will restart Claude:
- Validate git state -- same checks as
/exit(no uncommitted changes, no unpushed commits) - Save continuation state -- optionally write a continuation prompt so the restarted session picks up where you left off
- Send SIGINT -- gracefully exit the session
- Launcher restarts -- the wrapper script (e.g.,
run-agent.sh) detects the exit and starts a new Claude session
Prerequisites
- A launcher script that restarts Claude after exit (e.g., a
while trueloop) - If no launcher is present, restart behaves identically to exit -- the session simply ends
Quick Method
Use the exit script -- restart is just exit with launcher support:
${CLAUDE_PLUGIN_ROOT}/bin/exit.sh
Saving Continuation State
Before restarting, you may want to save state so the new session can resume:
- Write a continuation prompt to
.claude/tmp/continuation-prompt.md - Update
.claude/scratch/tasks.mdwith current progress - Commit any in-progress work
The launcher script or SessionStart hook can then read the continuation prompt on startup.
Difference from Exit
| Aspect | /exit | /restart |
| ------------------ | --------------- | ------------------------ |
| Intent | End the session | Restart with fresh state |
| Mechanism | SIGINT | SIGINT (same) |
| Launcher behavior | Session ends | Launcher restarts Claude |
| State preservation | Not expected | Save continuation prompt |
| Git validation | Required | Required |
See Also
/exit-- graceful session exit without restartrestartskill in the project repo -- may contain project-specific restart procedures
Related Skills
nsheaps/claude-code
tools
VerifiedTrustedCommunity
Reference material for Claude Code internals — the on-disk layout under ~/.claude and project-scope .claude, the plugin cache, session-env propagation, and the full hook lifecycle. Auto-recall when working on Claude-Code-related tasks: writing or debugging hooks, authoring plugins, inspecting session state, troubleshooting why an env var is or isn't visible to a Bash tool call, or when paths under ~/.claude or ~/.claude/plugins/ come up.
3SKILL.mdUpdated May 6, 2026
nsheaps/github-app-token
development
VerifiedTrustedCommunity
Manage GitHub App installation tokens in Claude Code sessions. Use when tokens expire, auth errors occur in long-running sessions, or when setting up GitHub App credentials for agent teams. <example>my github token expired</example> <example>refresh the github app token</example> <example>check token status</example> <example>set up github app authentication for this session</example>
3SKILL.mdUpdated Apr 22, 2026
nsheaps/auto-config
tools
VerifiedTrustedCommunity
Auto-detect project formatting tools and configure edit-utils settings
3SKILL.mdUpdated Apr 22, 2026
nsheaps/op
tools
VerifiedTrustedCommunity
Use this skill when the user asks about 1Password, secrets management, retrieving credentials, using op CLI, service accounts, secret references, vault operations, or any task involving the 1Password CLI (op). Also use when needing to inject secrets into environment variables, read passwords or API keys from 1Password, or manage 1Password items from the command line.
3SKILL.mdUpdated Apr 22, 2026