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.