BundleClaw — Node CLI

TypeScript implementation of the BundleClaw migration CLI.

Install

# Global install
npm install -g bundleclaw

# Or run directly
npx bundleclaw --help

Usage

# Export agent state
npx bundleclaw export \
  --source ~/.openclaw \
  --workspace ~/.openclaw/workspace \
  --profile full \
  --encrypt-pass 'strong-passphrase' \
  --out agent-state.bcz

# Import on target machine
npx bundleclaw import \
  --bundle agent-state.bcz \
  --target ~/.openclaw \
  --encrypt-pass 'strong-passphrase'

# Verify integrity
npx bundleclaw verify --target ~/.openclaw

# Transfer via SCP
npx bundleclaw transfer \
  --bundle agent-state.bcz \
  --to user@host:/tmp/agent-state.bcz

# Full bootstrap (import + verify + restart + health check)
npx bundleclaw bootstrap \
  --bundle agent-state.bcz \
  --encrypt-pass 'strong-passphrase' \
  --target ~/.openclaw

Development

npm install
npm run dev -- --help        # Run without compiling
npm run build                # Compile TypeScript to dist/

Tech Stack

• TypeScript (ES2022, strict mode)
• Commander.js for CLI argument parsing
• adm-zip for ZIP archive handling
• Node crypto for AES-256-GCM encryption

Interoperability

Bundles created with this CLI are fully compatible with the Python CLI. The shared .bcz format is documented in spec/FORMAT.md.

License

MIT