ralph-session-backup

Back up Ralph sessions to Google Drive with timestamped version folders.

5|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/arisng/github-copilot-fc --skill ralph-session-backup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ralph-session-backup
Source: https://github.com/arisng/github-copilot-fc/tree/main/skills/ralph-session-backup
Command: npx skills add https://github.com/arisng/github-copilot-fc --skill ralph-session-backup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Backup Ralph sessions from .ralph-sessions to Google Drive SwarmSessions with versioning to preserve history and enable restoration.

Core Features & Use Cases

  • Versioned backups: timestamped backups stored under repo-specific folders.
  • Cross-platform compatibility: Windows and Linux/WSL support with latest-win and latest-linux links.
  • Lifecycle management: list versions and prune old backups.

Quick Start

  • Run a backup: python3 <skill_directory>/scripts/backup_session.py <session_name>
  • List versions: python3 <skill_directory>/scripts/backup_session.py <session_name> --list
  • Cleanup to keep N: python3 <skill_directory>/scripts/backup_session.py <session_name> --cleanup=N

Frequently Asked Questions about ralph-session-backup

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

FAQPage Schema
How do I back up Ralph sessions to Google Drive with version history?▼

You can back up Ralph sessions by running the backup script with a session name, which copies data from .ralph-sessions to Google Drive SwarmSessions using timestamped version folders to preserve history.

Does the Ralph session backup script support both Windows and Linux?▼

Yes, the Ralph session backup script supports cross-platform compatibility by creating latest-win junctions for Windows and latest-linux symlinks for Linux or WSL environments.

How do I list or clean up old Ralph session backups on Google Drive?▼

You can list existing timestamped versions by passing the --list flag, or prune older backups and keep only the latest N versions by using the --cleanup=N parameter with the backup script.

What do I need to set up before running automated Ralph session backups?▼

You need Python 3 with standard libraries installed, a local .ralph-sessions directory, and a writable Google Drive SwarmSessions destination configured at your home or Windows path.

Can I limit Ralph session backups to a specific repository scope?▼

Yes, the backup script uses a repo-name context derived from your current working directory to organize versioned backups into repository-specific folders on Google Drive.

What is the best way to automate versioned backups of local session files to cloud storage?▼

Automating versioned backups to cloud storage is best handled by a script that creates timestamped folders, generates cross-platform latest links, and prunes old versions, which this backup script does for Ralph sessions.