OmniRoute Backup and Sync CLI
diegosouzapw/OmniRoute
Backup and restore OmniRoute data from the CLI. Trigger incremental snapshots, sync to cloud storage, manage backup schedules, and restore from archive files.
Verify a vault backup, prove it restores, or restore it to a folder of the user's choosing.
Install Backup Restore
$ npx skills add davekilleen/Dex --skill backup-restore -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install davekilleen/Dex backup-restore --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/davekilleen/Dex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/backup-restore .claude/skills/backup-restore && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "backup-restore" agent skill from https://github.com/davekilleen/Dex/tree/main/.agents/skills/backup-restore into .claude/skills/backup-restore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "backup-restore", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/davekilleen/Dex/tree/main/.agents/skills/backup-restoreType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add davekilleen/Dex --skill backup-restore -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install davekilleen/Dex backup-restore --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davekilleen/Dex.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/backup-restore .agents/skills/backup-restore && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "backup-restore" agent skill from https://github.com/davekilleen/Dex/tree/main/.agents/skills/backup-restore into .agents/skills/backup-restore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "backup-restore", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add davekilleen/Dex --skill backup-restore -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install davekilleen/Dex backup-restore --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davekilleen/Dex.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/backup-restore .cursor/skills/backup-restore && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "backup-restore" agent skill from https://github.com/davekilleen/Dex/tree/main/.agents/skills/backup-restore into .cursor/skills/backup-restore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "backup-restore", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/davekilleen/Dex.git --path .agents/skills/backup-restore--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add davekilleen/Dex --skill backup-restore -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install davekilleen/Dex backup-restore --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davekilleen/Dex.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/backup-restore .gemini/skills/backup-restore && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "backup-restore" agent skill from https://github.com/davekilleen/Dex/tree/main/.agents/skills/backup-restore into .gemini/skills/backup-restore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "backup-restore", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install davekilleen/Dex backup-restoreInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add davekilleen/Dex --skill backup-restore -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/davekilleen/Dex.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/backup-restore .github/skills/backup-restore && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "backup-restore" agent skill from https://github.com/davekilleen/Dex/tree/main/.agents/skills/backup-restore into .github/skills/backup-restore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "backup-restore", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add davekilleen/Dex --skill backup-restore -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install davekilleen/Dex backup-restore --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davekilleen/Dex.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/backup-restore .opencode/skills/backup-restore && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "backup-restore" agent skill from https://github.com/davekilleen/Dex/tree/main/.agents/skills/backup-restore into .opencode/skills/backup-restore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "backup-restore", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
backup-restore- GitHub stars
- 493
- Token cost
- ~725 tokens
- SKILL.md length
- 343 words
- Files
- 1
- Skills in repo
- 61
- Repo updated
- First seen
- Licence
- MIT
At a glance
Verify a vault backup, prove it restores, or restore it to a folder of the user's choosing.
- Works in 3 steps: The live vault was not touched. The… → The version history comes back… → Secrets and schedules are not in the…
- The user says restore my backup
- SKILL.md covers Test mode (the one to suggest…, Verify only (quick integrity…, Restore for real and For cloud (rclone) backups, plus 1 more section
- Calls python3 and git
What it does
Backup Restore is an agent skill from davekilleen/Dex. Verify a vault backup, prove it restores, or restore it to a folder of the user's choosing. Use when the user says 'restore my backup', 'test my backups', 'are my backups any good', or after data loss. Never overwrites the live vault. Not for taking a backup (backup-now); not for scheduling (backup-setup).
Its SKILL.md is about 730 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in DevOps & Cloud, covering Backup and disaster recovery. The repository describes itself as: Your AI Chief of Staff — a personal operating system starter kit that adapts to your role. No coding required. The licence is MIT.
When your agent uses it
- The user says restore my backup
- Test my backups
- Are my backups any good
- After data loss
Example prompts
- “s choosing. Use when the user says”
- “test my backups”
- “are my backups any good”
- “/backup-restore”
Requirements
- Python 3
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- The live vault was not touched. The restored copy sits in the folder they chose. Comparing, cherry-picking files, or swapping the whole…
- The version history comes back separately. The history bundle is copied alongside; git clone dex-vault-.bundle restored-history recovers it.
- Secrets and schedules are not in the backup, on purpose. API keys, the scheduled backup job itself, and macOS permissions all need…
What it can do on your machine
Read from SKILL.md and the folder at commit 227f78e. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
python3git
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Backup Restore loads about 725 tokens when it runs. Until then it costs about 82 tokens; SKILL.md has 343 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from davekilleen/Dex at commit 227f78e, republished under its MIT licence (© davekilleen). 343 words, ~725 tokens.
Download SKILL.mdSave it as
.claude/skills/backup-restore/SKILL.md (or your agent's skills folder).- name
- backup-restore
- description
- Verify a vault backup, prove it restores, or restore it to a folder of the user's choosing. Use when the user says 'restore my backup', 'test my backups', 'are my backups any good', or after data loss. Never overwrites the live vault. Not for taking a backup (`backup-now`); not for scheduling (`backup-setup`).
<!-- Generated from `.claude/skills/backup-restore/SKILL.md` by `scripts/generate-agents-skills.py`. Do not edit. -->Backup Restore
Three jobs, in increasing weight: prove a backup is intact, prove it actually restores, and bring one back. All three are driven by one tool, and none of them will ever overwrite the live vault: a restore always goes to a fresh folder the user chooses, to inspect and move into place themselves.
Test mode (the one to suggest routinely)
python3 core/backup/restore_vault.py testThis checks the newest set's fingerprints, verifies the version-history bundle with git's own verifier, extracts the whole archive into a throwaway temporary folder, counts what came out, and deletes the extraction. It proves a restore works without touching anything. Suggest running it once after setup and occasionally after that; a backup that has never been test-restored is a hope, not a backup.
Verify only (quick integrity check)
python3 core/backup/restore_vault.py verifyFingerprint and history checks only, no extraction. Add --set <stamp> for a specific older set, or --source /path for a folder other than the configured destination.
Show full SKILL.md (188 more words)Show less
Restore for real
First ask which set they want (default is the newest) and where the restored copy should go. The target must be a new or empty folder.
python3 core/backup/restore_vault.py restore --to /path/to/fresh-folderThen be explicit about three things:
- The live vault was not touched. The restored copy sits in the folder they chose. Comparing, cherry-picking files, or swapping the whole vault over is their deliberate next step, not something this tool does behind their back.
- The version history comes back separately. The history bundle is copied alongside;
git clone dex-vault-<stamp>.bundle restored-historyrecovers it. - Secrets and schedules are not in the backup, on purpose. API keys, the scheduled backup job itself, and macOS permissions all need re-establishing. Walk them through
docs/backup-restore.mdfor the full list.
For cloud (rclone) backups
The tool is honest about not reaching into the network: copy one set down first (rclone copy remote:path/dex-vault-<stamp>.* /some/local/folder/), then point --source at that folder.
Report honestly
Report exactly what the tool printed. If verification failed, the copy in storage is damaged: say so plainly, and suggest trying the next-oldest set (--set) rather than pretending the newest one is usable.
© davekilleen, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .agents/skills/backup-restore of davekilleen/Dex.
Open the folder on GitHubat commit 227f78e
Compare with similar skills
Backup Restore next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Backup Restore this skilldavekilleen/Dex | 493 | — | ~725 | Automated safety check: Pass | MIT | |
| OmniRoute Backup and Sync CLIdiegosouzapw/OmniRoute | 74k | — | ~948 | Automated safety check: Pass | MIT | |
| Pymobiledevice3 Device Operatordoronz88/pymobiledevice3 | 2.9k | — | ~1.8k | Automated safety check: Notes | GPL-3.0 | |
| Myclaw BackupLeoYeAI/openclaw-backup | 659 | — | ~1.8k | Automated safety check: Pass | MIT | |
| OmniRoute Database Backupsdiegosouzapw/OmniRoute | 74k | — | ~395 | Automated safety check: Pass | MIT | |
| Tempsgotempsh/temps | 828 | — | ~2k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Pymobiledevice3 Device Operator
doronz88/pymobiledevice3
Operate iOS and iPadOS devices with pymobiledevice3, from a local checkout or straight from PyPI via uvx on a fresh workstation.
Myclaw Backup
LeoYeAI/openclaw-backup
Backup and restore all OpenClaw configuration, agent memory, skills, and workspace data.
OmniRoute Database Backups
diegosouzapw/OmniRoute
Trigger system backups, restore from backup files, and manage the SQLite database lifecycle. Supports export, import, and incremental snapshot strategies.
Temps
gotempsh/temps
Manage, deploy, operate, and instrument applications with Temps.
Hermes Offsite Backup
OnlyTerp/hermes-optimization-guide
Set up encrypted off-machine Hermes backups. An agent skill from OnlyTerp/hermes-optimization-guide.
More from davekilleen/Dex
All 61 skills in this repoDspy Ruby
davekilleen/Dex
This skill should be used when working with DSPy.rb, a Ruby framework for building type-safe, composable LLM applications.
Diff Adopt Profile
davekilleen/Dex
Adopt a full published Heydex profile by handle ('set me up like @davekilleen').
Diff Generate
davekilleen/Dex
Package one workflow — how you use Dex for a specific job — into a shareable DexDiff methodology doc.
Creating Agent Skills
davekilleen/Dex
Expert guidance for creating, writing, and refining Claude Code Skills.
Feedback
davekilleen/Dex
Report a Dex bug to the Dex team with zero homework — Dex investigates locally, builds a privacy-safe report, shows it to you (or auto-sends if you've chosen that), and tracks the ticket until it's…
Dhh Rails Style
davekilleen/Dex
This skill should be used when writing Ruby and Rails code in DHH's distinctive 37signals style.
Related
Categories
Questions about Backup Restore
What does Backup Restore do?
Verify a vault backup, prove it restores, or restore it to a folder of the user's choosing. Backup Restore is an agent skill from davekilleen/Dex. Verify a vault backup, prove it restores, or restore it to a folder of the user's choosing.
When should I use Backup Restore?
Backup Restore fits situations like: the user says restore my backup; test my backups; are my backups any good; after data loss.
How do I install Backup Restore in Claude Code?
Run `npx skills add davekilleen/Dex --skill backup-restore -a claude-code`. Or copy the skill folder (.agents/skills/backup-restore in davekilleen/Dex) into .claude/skills/backup-restore in your project. Claude Code loads it when a task matches its description.
How do I install Backup Restore in Codex?
Run `npx skills add davekilleen/Dex --skill backup-restore -a codex`. Or copy the skill folder (.agents/skills/backup-restore in davekilleen/Dex) into .agents/skills/backup-restore in your project. Codex loads it when a task matches its description.
Can I use Backup Restore in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davekilleen/Dex --skill backup-restore -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/backup-restore, .gemini/skills/backup-restore, .github/skills/backup-restore and .opencode/skills/backup-restore in your project.
What does Backup Restore need to run?
Going by SKILL.md and its folder, Backup Restore needs the command-line tools its instructions call (python3 and git). Our summary lists: Python 3.
Does Backup Restore access the network?
SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Backup Restore safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Backup Restore use?
Backup Restore is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Backup Restore use?
About 725 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Backup Restore?
Skills that share tags, products or a category with Backup Restore: OmniRoute Backup and Sync CLI (diegosouzapw/OmniRoute, 74k stars), Pymobiledevice3 Device Operator (doronz88/pymobiledevice3, 2.9k stars), Myclaw Backup (LeoYeAI/openclaw-backup, 659 stars) and OmniRoute Database Backups (diegosouzapw/OmniRoute, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Backup Restore?
davekilleen (a GitHub user) maintains it in davekilleen/Dex, which has 493 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on October 8, 2026.
Source: davekilleen/Dex on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.