🛡️ AgentShield

English | 中文

The missing safety layer for Claude Code, Cowork, OpenCode and all AI Agents - Your "regret pill" for AI-assisted development.

A workspace history version management tool that protects your workspace from unintended AI Agent modifications.

!demo

✨ Features

- ⚡ Zero-Copy Backups - Uses hardlinks for instant, space-efficient backups
- 🕵️ Real-time Protection - Watches your workspace and automatically backs up files before changes
- 📦 Smart Exclusions - Automatically ignores .git, node_modules, build artifacts, etc.
- 🔒 Atomic Exec Mode - Snapshot entire workspace before running agent commands
- ⏮️ Easy Restore - One command to roll back any file to its original state

🚀 Installation

$3

Download the corresponding platform installation package from the Releases page and extract it to install (supports Windows, macOS, Linux).

- shield_desktop_darwin_arm64.dmg (macOS arm64)
- shield_desktop_darwin_x64.dmg (macOS x64)
- shield_desktop_linux_arm64.tar.gz (Linux arm64)
- shield_desktop_linux_x64.tar.gz (Linux x64)
- shield_desktop_win_x64.exe (Windows x64)

$3

Via npm installation

``bash
npm install -g agentshield
`

Via binary installation

`bash
curl -fsSL https://github.com/tomsun28/agentshield/raw/main/install.sh | bash
`

Or download the executable binary for your platform from the Releases page (supports Windows, macOS, Linux).

- shield_cli_darwin_arm64 (macOS arm64)
- shield_cli_darwin_x64 (macOS x64)
- shield_cli_linux_arm64 (Linux arm64)
- shield_cli_linux_x64 (Linux x64)
- shield_cli_win_x64.exe (Windows x64)

📖 Usage




$3

> Support background daemon mode shield start and foreground mode shield watch, choose one.

`bash


Start background watch (recommended)

shield start

Start background watch for specific directory

shield start ./my-project

Watch current directory (foreground)

shield watch

Watch specific directory (foreground)

shield watch ./my-project

Stop background process

shield stop
shield stop ./my-project

Check status

shield status
`

$3

`bash


List all changes and snapshot points

shield list

Restore a specific snapshot by ID or timestamp

shield restore
`

$3

`bash


Show backup statistics and daemon status

shield status

Remove backups older than 7 days (default)

shield clean

Remove backups older than 3 days

shield clean --days=3
``

🤝 Contributing

Issues and Pull Requests are very welcome!

📄 License

Apache License 2.0