🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Clawkeep
πŸ¦€ ClawHub

Clawkeep

by @taco-devs

Provides git-powered versioned backups and safe snapshot recovery for workspace files, with automated and manual snapshot options.

Versionv0.2.9
Downloads859
#finance#legal#automation
TERMINAL
clawhub install clawkeep

πŸ“– About This Skill

ClawKeep β€” Agent Skill

> Git-powered versioned backups for your workspace. Every change tracked, every state recoverable.

Overview

ClawKeep gives you version-controlled backups of your workspace files. You can go back to any point in time if something goes wrong β€” a bad memory update, corrupted config, accidental deletion.

Prerequisites

ClawKeep must be installed globally: 

npm install -g clawkeep

Verify: clawkeep --version

Setup (One Time)

Initialize ClawKeep on your workspace:

cd /path/to/your/workspace
clawkeep init

This creates:

  • .clawkeep/config.json β€” minimal config
  • .clawkeepignore β€” patterns for files to skip (node_modules, .env, logs, etc.)
  • .gitignore β€” auto-synced from .clawkeepignore
  • An initial snapshot of all tracked files

    • Taking Snapshots

    Watch Daemon (Recommended)

    Start a background daemon that auto-snapshots on every file change:

    clawkeep watch --daemon -d /path/to/workspace --interval 10000

  • Runs in background, survives terminal close
  • Debounces writes (default 10s) to avoid spam commits
  • Stop with: clawkeep watch --stop -d /path/to/workspace

    • Manual Snapshots

    # Quick snapshot (only commits if files changed)
clawkeep snap -d /path/to/workspace -q
    Named snapshot
    
clawkeep snap -d /path/to/workspace -m "before risky changes"

    Recovery

    # See available snapshots
clawkeep log -d /path/to/workspace
    Restore to a specific snapshot (non-destructive β€” creates new commit)
    
clawkeep restore  -d /path/to/workspace
    Restore to N snapshots ago
    
clawkeep restore HEAD~3 -d /path/to/workspace

    Restores are safe β€” they check out the old state and commit it as a new snapshot. Your full history is preserved.

    Checking Status

    # Quick status
clawkeep status -d /path/to/workspace
    See what changed since last snapshot
    
clawkeep diff -d /path/to/workspace
    View timeline
    
clawkeep log -d /path/to/workspace -n 10

    Ignore Patterns

    Edit .clawkeepignore in your workspace root to exclude files from tracking. Patterns are auto-synced to .gitignore.

    Web Dashboard

    clawkeep ui --daemon -d /path/to/workspace --port 3333

    Visual timeline, file browser with time-travel, side-by-side diffs, one-click restore. Token-based auth is auto-generated.

    Encrypted Backup Targets

    For off-site encrypted backups, choose a target and follow its dedicated skill:

    | Target | Skill | Description | |---|---|---| | Local path | skills/local/SKILL.md | NAS, USB drive, external disk, network share | | S3 / R2 | skills/s3/SKILL.md | Cloudflare R2, AWS S3, Backblaze B2, MinIO, Wasabi | | ClawKeep Cloud | skills/clawkeep-cloud/SKILL.md | Managed zero-knowledge backup with browser-based setup |

    All targets use AES-256-GCM encryption. Your backup destination only sees opaque .enc chunk files β€” no file names, no metadata, no structure.

    Quick Reference

    | Action | Command | |---|---| | Initialize | clawkeep init -d

    | | Auto-backup daemon | clawkeep watch --daemon -d | | Stop daemon | clawkeep watch --stop -d | | Manual backup | clawkeep snap -d -m "message" | | View history | clawkeep log -d | | Restore | clawkeep restore -d | | See changes | clawkeep diff -d | | Launch dashboard | clawkeep ui --daemon -d --port 3333 | | Stop dashboard | clawkeep ui --stop -d | | Export encrypted | clawkeep export -d -p "password" |

    βš™οΈ Configuration

    ClawKeep must be installed globally: 

    npm install -g clawkeep

    Verify: clawkeep --version