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 \x3Chash> -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:

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