arisng/ralph-session-backup
skills/ralph-session-backup/SKILL.md
Backup a specific Ralph session directory from .ralph-sessions to the Google Drive SwarmSessions folder with versioning support. Use when archiving or copying Ralph session data with all nested files and folders. Auto-zips older backups to save space.
$ install --global
skillsauthnpx skillsauth add arisng/github-copilot-fc ralph-session-backupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 12, 2026, 3:17 AM171.4s1 file scanned
SKILL.md
- name:
- ralph-session-backup
- description:
- Backup a specific Ralph session directory from .ralph-sessions to the Google Drive SwarmSessions folder with versioning support. Use when archiving or copying Ralph session data with all nested files and folders. Auto-zips older backups to save space.
- version:
- 1.8.0
- author:
- arisng
Ralph Session Backup
This skill provides a script to backup Ralph sessions with versioning support. Each session maintains multiple timestamped backups, organized under repository-specific folders to avoid naming conflicts between different repositories.
Usage
To backup a specific session:
- First, resolve the skill directory location (this skill's folder containing SKILL.md)
- Navigate to the repository root directory where .ralph-sessions exists
- Run the backup script with a path resolved relative to the skill directory:
python3 <skill_directory>/scripts/backup_session.py <session_name>
Important: The script path must be resolved relative to the current skill directory location. This requires first determining where this skill is installed (e.g., in personal Copilot folders like .claude, .copilot, etc.) before executing the script.
Versioning & Storage Optimization
The script creates a versioned backup structure and auto-zips older backups to optimize storage:
SwarmSessions/
└── <repo_name>/
└── <session_name>/ # Session folder (YYMMDD-HHMMSS)
├── backup_YYMMDD-HHMMSS/ # Latest backup (unzipped directory)
├── backup_YYMMDD-HHMMSS.zip # Older backups (auto-zipped)
├── latest-win/ # Windows junction point -> latest backup directory
└── latest-linux/ # Linux symlink -> latest backup directory
Auto-Zipping Logic: When a new backup is created, the script automatically zips any existing unzipped backup directories in the session folder. Only the most recent backup remains as an unzipped directory for easy access via the latest links.
Command Options
python3 backup_session.py <session_name>- Create a new versioned backuppython3 backup_session.py <session_name> --list- List all existing versionspython3 backup_session.py <session_name> --cleanup=N- Keep only the last N versions (default: 5)python3 backup_session.py <session_name> --get-latest-path- Print the path to the latest session version (platform-specific)
Recovery
To restore from a specific version:
- Navigate to
SwarmSessions/<repo_name>/<session_name>/ - Copy the desired
backup_YYMMDD-HHMMSSfolder back to.ralph-sessions/<session_name> - Or use
latest-win/(Windows) orlatest-linux/(Linux/WSL) for the most recent backup
Cross-Platform Access
The script creates platform-specific link variants:
latest-win/: Windows junction point (transparent directory link, no admin rights needed)latest-linux/: Linux symlink (works in WSL and native Linux)
Both links point to the most recent backup and are created regardless of the current platform. If link creation fails, a warning is shown but the backup still succeeds.
Requirements
- Python 3.8 or higher
- The session folder must exist in
.ralph-sessions - Write access to the Google Drive folder
- Cross-platform: Works on Windows and WSL (backs up to Windows filesystem)
Related Skills
arisng/tldraw-creator
devops
VerifiedTrustedCommunity
Programmatically create tldraw whiteboards and visualize them with a self-hosted tldraw instance. Create boards with shapes, text, and connectors, then deploy to a self-hosted server for collaborative editing and gallery management.
3SKILL.mdUpdated May 30, 2026
arisng/gcloud-cli
tools
VerifiedTrustedCommunity
Execute Google Cloud Platform operations using the gcloud CLI (and gsutil/bq where applicable). Use when the user wants to: authenticate with GCP, manage GCP resources, deploy applications, configure projects or IAM, view logs, run SQL/BigQuery, or interact with any GCP service from the command line. Triggers on phrases like "gcloud", "Google Cloud CLI", "deploy to GCP", "create a VM", "Cloud Run", "GKE cluster", "Cloud Storage bucket", "set GCP project", "service account", "Cloud Functions", "App Engine deploy", or any request to manage Google Cloud resources via command line.
3SKILL.mdUpdated May 29, 2026
arisng/grill-with-docs
testing
VerifiedTrustedCommunity
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
3SKILL.mdUpdated May 26, 2026
arisng/git-session-atomic-commits
development
VerifiedTrustedCommunity
Session-scoped git commit orchestrator that commits only current-session changes and leaves unrelated dirty worktree edits untouched. Inherits git-atomic-commit for atomic grouping and commit message execution, and git-commit-scope-constitution for scope governance and validation. Use when asked to commit this session only or isolate commits from mixed worktree state.
3SKILL.mdUpdated May 23, 2026