polymath-void/ai-agents-skills-workspace/agy-gdrive-backup
Claude Code and agent skill by polymath-void/ai-agents-skills-workspace
- community
Checking that the SKILL.md file is still in the repository.
Comprehensive workflow and procedures for backing up, restoring, authenticating, and verifying AGY CLI user data with Google Drive.
Install
npx vskill@latest install polymath-void/ai-agents-skills-workspace/agy-gdrive-backupSKILL.md
The same SKILL.md was published earlier as polymath-void/ai-agents-skills-workspace/agy-gdrive-backup.
AGY User Data Google Drive Backup & Restore Skill
Overview
This skill defines standard operating procedures and workflows for managing, backing up, authenticating, and restoring AGY CLI (agy) user data to and from Google Drive.
Data Scope & Target Directories
- Source Directory:
~/.gemini/antigravity-cli($HOME/.gemini/antigravity-cli) - Remote Cloud Path: Google Drive
/AGY_Backups/
1. Inclusions (Essential User Data)
settings.json(CLI configuration & permissions)knowledge/(Saved user rules & domain knowledge)skills/(Custom user skills & workflows)memory/(Persistent session memory)history.jsonl(Prompt & execution history)conversations/&conversation_summaries.db(Session databases)brain/(Artifacts, scratch scripts, subagent transcripts)mcp_config.json&mcp/(Model Context Protocol configs)
2. Exclusions (Ephemeral & Cache Files)
cache/(Downloaded models or temp asset caches)cli.log(Current session runtime logs)crashes/&updater/(Crash dumps and update state)- Temporary
.lockfiles or socket listeners
Workflows & Standard Procedures
Workflow 1: Google Drive Authentication (OAuth2)
- Credentials Setup:
- Obtain Google OAuth Client ID & Client Secret (Google Cloud Console with Drive API enabled).
- Store OAuth credentials securely in
~/.gemini/antigravity-cli/gdrive_credentials.json.
- Interactive Authorization:
- Run
agy-backup auth. - Complete browser/device-code authorization flow to issue refresh & access tokens.
- Tokens stored securely at
~/.gemini/antigravity-cli/gdrive_token.json.
Workflow 2: Automated Cloud Backup
- Archive Generation:
- Compress included directories into a timestamped
.tar.gzbundle:
agy_backup_YYYY-MM-DD_HHMMSS.tar.gz
- Calculate SHA256 checksum:
agy_backup_YYYY-MM-DD_HHMMSS.tar.gz.sha256.
- Upload to Google Drive:
- Connect via Google Drive API v3.
- Upload both archive and checksum file into the
/AGY_Backupsfolder.
- Retention & Pruning:
- Keep the most recent 10 backups on Google Drive. Auto-prune older snapshots.
Workflow 3: Complete Restoration (Safety First)
When restoring user data to a new device or recovering state:
- Pre-Restore Safety Snapshot:
- ALWAYS create a local pre-restore safety copy of existing
~/.gemini/antigravity-clibefore proceeding:
cp -r ~/.gemini/antigravity-cli ~/.gemini/antigravity-cli.pre-restore.bak
- Select & Fetch Remote Backup:
- Query Google Drive
/AGY_Backupsfor available backup archives. - Download the target backup
.tar.gzand corresponding.sha256checksum file.
- Checksum Verification:
- Verify local file hash matches
.sha256. Stop and fail if checksum fails.
- Controlled Extraction:
- Extract archive contents over
~/.gemini/antigravity-cli.
- Post-Restore Termux Verification & Cleanup:
- Run
termux-fix-shebangon executable scripts if restored on Android. - Verify
settings.jsonis valid JSON. - Clean up temporary restore files.
Workflow 4: Emergency Rollback Procedure
If a restoration attempt causes errors or invalid configuration:
- Stop any running AGY CLI instances.
- Remove corrupted directory:
rm -rf ~/.gemini/antigravity-cli - Restore pre-restore safety snapshot:
mv ~/.gemini/antigravity-cli.pre-restore.bak ~/.gemini/antigravity-cli - Confirm CLI functionality:
agy --helpor checksettings.json.
Utility Tool Command Reference
The agy-backup Python CLI utility implements these workflows:
| Command | Action | |
|---|---|---|
python3 -m agy_backup.cli auth | Authenticate with Google Drive OAuth2 | |
python3 -m agy_backup.cli backup | Create & upload backup archive to Google Drive | |
python3 -m agy_backup.cli list | List available backups on Google Drive | |
python3 -m agy_backup.cli restore [file_id] | Safely restore AGY user data from Google Drive | |
python3 -m agy_backup.cli status | Show auth & backup status |
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckinguser-skills/hermes/productivity/agy-gdrive-backup/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/polymath-void/ai-agents-skills-workspace/agy-gdrive-backup)