d1-time-travel

Back up D1 databases and restore them with Time Travel bookmarks.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/cffrank/paperclip-skills-agents --skill d1-time-travel
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: d1-time-travel
Source: https://github.com/cffrank/paperclip-skills-agents/tree/main/skills/d1-time-travel
Command: npx skills add https://github.com/cffrank/paperclip-skills-agents --skill d1-time-travel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Protect D1 databases by enabling reliable backups and point-in-time recovery with Time Travel.

Core Features & Use Cases

  • Time Travel backups: automatic retention and point-in-time restoration for D1.
  • Bookmark management and restores: create, list, and restore from named bookmarks.
  • Data export to R2: export snapshots to R2 for offsite storage and disaster recovery.
  • Backup verification and runbooks: verification steps and recovery playbooks for common failure scenarios.

Quick Start

Use this skill to back up D1 data, manage time-travel bookmarks, and perform point-in-time restores or data exports.

Frequently Asked Questions about d1-time-travel

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

FAQPage Schema
How do I restore a Cloudflare D1 database to a previous state?▼

You can restore a D1 database by creating a point-in-time Time Travel bookmark and then issuing a restore command to roll the database back. This allows reliable recovery from accidental data loss.

What is the best way to export D1 database snapshots to R2?▼

The best way to export D1 snapshots to R2 is using Time Travel to generate a snapshot and then exporting it directly to your R2 bucket. This provides offsite storage for disaster recovery.

How does point-in-time recovery work for D1 databases?▼

Point-in-time recovery for D1 works by using Time Travel to automatically retain database changes and create named bookmarks. You can restore the database to the exact moment a bookmark was created.

Can I verify my D1 backups before running a disaster recovery scenario?▼

Yes, you can verify D1 backups using provided verification steps and recovery runbooks. These playbooks guide you through common failure scenarios and migrations to ensure backup integrity.

Do I need Time Travel bookmarks for D1 database migrations?▼

Yes, Time Travel bookmarks are essential for D1 migrations because they provide a reliable restoration point. The skill includes runbooks that utilize bookmarks to safely manage migration scenarios.