claude-restart-resume

Restart Claude Code to reload configuration changes while preserving conversation history.

3|Updated Oct 17, 2025
One-click install
npx skills add https://github.com/ManuelKugelmann/BitBot --skill claude-restart-resume
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-restart-resume
Source: https://github.com/ManuelKugelmann/BitBot/tree/main/.claude/skills/claude-restart-resume
Command: npx skills add https://github.com/ManuelKugelmann/BitBot --skill claude-restart-resume

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux, and includes scripts (resource) components.

What problem does it solve?

Provides a fast and efficient way to apply configuration changes (like new skills or settings) to Claude without losing your current conversation history. This saves time by avoiding full restarts and context rebuilding.

Core Features & Use Cases

  • Configuration Reload: Instantly reloads all .claude/ files, including skills, settings, and hooks.
  • History Preservation: Ensures your ongoing conversation and context remain intact after the refresh.
  • Use Case: After updating a skill or modifying settings.json, use this to quickly apply changes and continue your work seamlessly.

Quick Start

Restart Claude to reload configurations and resume your session. .claude/skills/claude-restart-resume/scripts/claude-restart.sh resume

Frequently Asked Questions about claude-restart-resume

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

FAQPage Schema
How do I reload Claude configuration changes without losing my conversation history?

Reload Claude configuration by restarting the process while preserving history. Run the restart command with resume mode to apply changes to skills, settings, and hooks without context loss, maintaining your ongoing session.

Can I apply new skills or settings to Claude without restarting from scratch?

Yes. The restart-resume feature applies configuration changes instantly while keeping conversation history intact. After updating .claude/ files, use resume mode to refresh the runtime and continue working seamlessly.

What happens to my conversation when I restart Claude to reload configuration?

History preservation is built in. Restart Claude with resume mode to reload all .claude/ files—skills, settings, hooks—while your current conversation and context remain fully intact across the refresh.

Do I need tmux to use the restart and resume feature?

Yes, tmux is required. The Skill validates tmux context and Claude process ID, then uses tmux to fork a detached restart that reloads configuration while preserving your session state.

What are the different restart modes available when reloading Claude configuration?

Three modes are supported: resume (reload config, keep history), compact (compress and reload), and clear (restart fresh). Choose based on whether you need history preservation or a clean session.

When should I use restart-resume instead of a full restart?

Use restart-resume when you've modified .claude/ files and need changes applied quickly without rebuilding context. It's ideal for iterating on skills or settings during active work.