/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 -r and -i provided -> 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