/asciinema-tools:backup
Configure and manage streaming backup to GitHub orphan branch.
Arguments
| Argument | Description |
| ---------------- | -------------------------------------- |
| install | Configure and start backup automation |
| status | Show active backups and last sync |
| stop | Disable backup for current session |
| history | View recent backup commits |
| -r, --repo | GitHub repository (e.g., owner/repo) |
| -i, --interval | Sync interval (e.g., 30s, 5m) |
| --chunk | Split at idle time |
| --meta | Include session metadata |
Execution
Invoke the asciinema-streaming-backup skill with user-selected options.
Skip Logic
- If action provided -> skip Phase 1 (action selection)
- If
-rand-iprovided -> skip Phase 2-3 (config and repo)
Workflow
- Preflight: Check gh CLI and fswatch
- Action: AskUserQuestion for action type
- Config: AskUserQuestion for backup settings
- Repo: AskUserQuestion for repository selection
- Execute: Run selected action
Examples
# Check current backup status
/asciinema-tools:backup status
# Configure and start backup automation
/asciinema-tools:backup install
# View recent backup history
/asciinema-tools:backup history
# Stop backup for current session
/asciinema-tools:backup stop
Troubleshooting
| Issue | Cause | Solution |
| ------------------- | ---------------------------- | ----------------------------------- |
| gh not found | gh CLI not installed | brew install gh |
| fswatch not found | fswatch not installed | brew install fswatch |
| Auth error | GitHub token invalid/expired | Run gh auth login |
| Orphan branch error | Branch not initialized | Run /asciinema-tools:daemon-setup |
| No recordings found | No active .cast files | Start a recording first |