system-recovery-mode

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

curl -fsSL https://hosted.danielrosehill.com/claude-rescue/bootstrap.sh | sudo bash

curl -fsSL https://hosted.danielrosehill.com/claude-rescue/v1/bootstrap.sh | sudo bash

curl -fsSL https://raw.githubusercontent.com/danielrosehill/Claude-System-Recovery-Mode/main/bootstrap.sh | sudo bash

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

1. Reboot your system
2. At the GRUB menu, select "Claude Recovery Mode"
3. The system will boot to a minimal TTY environment
4. A warning banner will be displayed
5. 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:

1. Profiles your system — Gathers OS version, hardware info, and system state
2. Collects your diagnosis — Asks you to describe the problem you're experiencing
3. Begins remediation — Uses the gathered context to diagnose and fix the issue

Individual Workflow Commands

You can also run each step independently: