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.