A custom GRUB boot entry that provides AI-assisted system recovery using Claude CLI.
Instead of booting into a blank recovery shell, this mode launches directly into Claude CLI, giving you an intelligent assistant to help diagnose and fix system issues.
This repo doubles as a Claude Code plugin — install it via the Claude Code marketplace and you'll get the recovery commands (/status, /errors, /failed, /network-check, /boot-log, /fix-packages) and agents (diagnose, logs, network, disk, services, packages) inside any normal Claude Code session, without the GRUB/systemd install. Install via /plugin marketplace add danielrosehill/Claude-Code-Plugins then /plugin install system-recovery-mode@danielrosehill.
Features
- Guided Recovery Workflow: Pre-populated slash commands guide you through diagnosis and remediation
- One-Command Start:
/start runs the full recovery workflow—profiles your system, gathers your diagnosis, and begins remediation
- GRUB Boot Entry: Adds "Claude Recovery Mode" to your boot menu
- Minimal Boot: Boots to a text-only TTY (no GUI overhead)
- Auto-Login: Automatically logs in as your specified user
- Claude CLI: Launches Claude immediately upon login
- Recovery Agents: Pre-configured agents for diagnostics, logs, network, disk, services, and packages
- Recovery Commands: Quick slash commands for common recovery tasks
- Network Enabled: Boots with networking for Claude API access
- Auto-Install: If Claude CLI isn't installed, it will attempt to install it automatically
- Updateable: Recovery tools can be updated from GitHub with a single command
Quick Install
One command to install Claude Recovery Mode:
curl -fsSL https://bit.ly/claude-rescue | sudo bash
Options:
# Install for specific user
curl -fsSL https://bit.ly/claude-rescue | sudo bash -s -- --user myuser
# Install for root
curl -fsSL https://bit.ly/claude-rescue | sudo bash -s -- --root
Alternative URLs & Notes
The Bitly link is provided for convenience at the terminal—no usage tracking is performed. If you prefer, you can use the hosted URL or fetch directly from GitHub:
Hosted URL (always points to latest):
curl -fsSL https://hosted.danielrosehill.com/claude-rescue/bootstrap.sh | sudo bash
Versioned URL (v1):
curl -fsSL https://hosted.danielrosehill.com/claude-rescue/v1/bootstrap.sh | sudo bash
Direct from GitHub:
curl -fsSL https://raw.githubusercontent.com/danielrosehill/Claude-System-Recovery-Mode/main/bootstrap.sh | sudo bash
The Bitly link redirects to the latest version. The versioned URL (v1) is provided for stability if you want to pin to a specific release.
Requirements
- Ubuntu/Debian-based Linux distribution
- systemd
- GRUB2 bootloader
- Internet connection (for Claude API)
- Anthropic API key configured for Claude CLI
Installation
Quick Install (Recommended)
See Quick Install above for the one-liner.
Manual Installation
If you prefer to inspect the code first or have the repo locally:
# Clone the repository
git clone https://github.com/danielrosehill/Claude-System-Recovery-Mode.git
cd Claude-System-Recovery-Mode
# Install with your current user (recommended)
sudo ./install.sh
# Or specify a different user
sudo ./install.sh --user myusername
# Or use root (use with caution)
sudo ./install.sh --root
Usage
- Reboot your system
- At the GRUB menu, select "Claude Recovery Mode"
- The system will boot to a minimal TTY environment
- A warning banner will be displayed
- Claude CLI will start automatically at the root directory (
/)
Within Claude Recovery Mode
- Use Claude to diagnose system issues, fix configurations, repair packages, etc.
- Type
exit or press Ctrl+C to exit Claude and return to a shell
- Type
/help within Claude for available commands
Guided Recovery Workflow
When Claude Recovery Mode launches, you'll see available slash commands displayed at the welcome screen. These commands are pre-configured specifically for recovery operations.
The /start Command (Recommended)
The easiest way to begin is with the master command:
/start
This runs the complete recovery workflow in sequence:
- Profiles your system — Gathers OS version, hardware info, and system state
- Collects your diagnosis — Asks you to describe the problem you're experiencing
- Begins remediation — Uses the gathered context to diagnose and fix the issue
Individual Workflow Commands
You can also run each step independently:
