Backup

Backup

Automated backup skill that creates timestamped archives of Cognithor configuration, skills, and data on a cron schedule (0 * * * * — hourly by default).

Steps

1. Check prerequisites — verify backup target exists and has write access:

   BACKUP_DIR="${COGNITHOR_HOME:-$HOME/.cognithor}/backups"
   mkdir -p "$BACKUP_DIR" && test -w "$BACKUP_DIR"
   

2. Create timestamped archive of config, skills, and data:

   STAMP=$(date +%Y%m%d_%H%M%S)
   tar czf "$BACKUP_DIR/cognithor_$STAMP.tar.gz" \
     -C "${COGNITHOR_HOME:-$HOME/.cognithor}" \
     config/ skills/ data/
   

3. Validate integrity — verify the archive is readable:

   tar tzf "$BACKUP_DIR/cognithor_$STAMP.tar.gz" > /dev/null
   

4. Prune old backups — keep the last 24 hourly snapshots:

   ls -1t "$BACKUP_DIR"/cognithor_*.tar.gz | tail -n +25 | xargs rm -f
   

5. Return status — the skill returns {"status": "ok", "automated": true} on success

Example

User > Starte ein Backup meiner Cognithor-Daten
Cognithor > Backup erstellt: cognithor_20260420_140000.tar.gz (12 MB)
         Nächstes automatisches Backup: 15:00 Uhr

Error Handling

• Disk full: Log warning, skip archive creation, alert user to free space
• Permission denied: Verify $BACKUP_DIR ownership and retry with correct permissions
• Corrupt archive: Re-run backup immediately; if persistent, check filesystem health