safe-install

Backs up, updates, uninstalls, and restores Lintel installations with visible snapshot management.

Updated May 27, 2026
One-click install
npx skills add https://github.com/jokerman89/lintel --skill safe-install-jokerman89
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: safe-install
Source: https://github.com/jokerman89/lintel/tree/main/skills/safe-install
Command: npx skills add https://github.com/jokerman89/lintel --skill safe-install-jokerman89

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Install, update, and uninstall operations on a Lintel home directory are destructive and irreversible, and the base installer offers no uninstall path or backup visibility, leaving operators without a recovery option when something goes wrong. ## Core Features & Use Cases - Version-before-every-change: Automatically snapshots the LINTEL_HOME directory before any update, uninstall, or standalone backup, and announces the backup path explicitly. - Uninstall with restore: Removes the installation only after operator confirmation and keeps the latest snapshot available for one-command restoration. - Snapshot management: Lists available restore points, restores a specific snapshot with confirmation, and prunes old backups (keeps latest 5 and anything under 30 days). - Use Case: Before pulling the latest Lintel update, run the update mode so a timestamped backup is created first; if the update fails, the skill auto-restores the snapshot and surfaces the error. ## Quick Start Ask the agent to run the safe-install update mode so it backs up the current Lintel installation and then applies the latest update with automatic rollback on failure.

Frequently Asked Questions about safe-install

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

FAQPage Schema
How do I safely update Lintel without losing my current setup?▼

Run the update mode, which first copies the current LINTEL_HOME into a timestamped snapshot under the backups directory, then pulls the latest source and runs the installer. If the update fails, it automatically restores the backup and reports the error.

How do I uninstall Lintel and restore it later?▼

Use the uninstall mode, which asks for confirmation, removes the LINTEL_HOME directory, and keeps the latest snapshot. Restore it anytime with the restore mode by passing the snapshot timestamp shown in the backup announcement.

Where are Lintel backups stored and how long are they kept?▼

Backups are stored as snapshot-<timestamp> folders in a backups directory next to LINTEL_HOME, and the path is printed after every backup. Retention keeps the latest 5 snapshots and deletes any older than 30 days.

When should I not use the safe-install wrapper?▼

Do not use it for first-time installation, since install/install.sh is the canonical path for that. For diagnosing current state or debugging mid-cycle, use bin/li-doctor instead.

What happens if a restore fails from a corrupted backup?▼

If a restore fails because the snapshot is corrupted, the workflow falls back to the previous snapshot and surfaces a warning. Disk-full conditions cause the operation to refuse and display free-space instructions.