Your agent can read email, write files, send messages, and call APIs. Do you know what it did while you were away?
See Everything. Rewind File Changes. Test Without Consequences.
UNWIND is a security layer for AI agents. Install it once, and every real-world action your agent takes — file writes, API calls, shell commands — is monitored, checked, and recorded. If something goes wrong, you'll know. If it changes a file, you can rewind it in one click.
Check on your agent from your phone. Green light means everything's fine. Amber means something needs your attention. Red means something was blocked.
No AI in the security path. Your agent doesn't know UNWIND exists.
OpenClaw users — tell your agent:
Install the UNWIND security engine with
pip install unwind-mcp, then install the experimental OpenClaw adapter from this repo withopenclaw plugins install ./openclaw-adapter. Restart the gateway when done.
Or manually:
pip install unwind-mcp
openclaw plugins install ./openclaw-adapterJust want to watch first? Ghost Mode shows you what your agent would do, without letting it do anything:
pip install ghostmode
ghostmode -- npx @modelcontextprotocol/server-filesystem ~/DocumentsMCP clients (Claude Desktop, Cursor, Windsurf, VS Code):
pip install unwind-mcp
unwind serve -- npx @modelcontextprotocol/server-filesystem ~/DocumentsPoint your client at UNWIND instead of the upstream server. The agent doesn't know it's there.
- Trust Light — a green, amber, or red indicator that tells you at a glance whether your agent is operating normally. Check it from your phone.
- Timeline — every action your agent took, when, and whether it was allowed. Expandable detail on each event. Scroll through it on mobile.
- Rewind — before every file write, UNWIND takes a snapshot. Changed your mind? One click to restore.
- While You Were Away — a summary of what happened while you weren't watching, with anything that needs your attention highlighted.
- Ghost Mode — test untrusted tools or risky prompts without consequences. Your agent thinks it worked, but nothing real changed.
Advanced controls: trusted source rules for scheduled tasks, 15-stage deterministic pipeline, tamper-evident audit chain.
Open http://your-machine:9001 from any browser — including your phone.
unwind dashboardSee what your agent is doing now, review what happened while you were away, undo file changes, toggle Ghost Mode, and verify the audit chain — all from one mobile-friendly page.
One core engine, multiple adapters. UNWIND works with OpenClaw, standard MCP clients, and any agent framework that can route tool calls through a proxy or sidecar.
| Platform | Integration |
|---|---|
| OpenClaw | Native plugin (fail-closed) |
| Claude Desktop, Cursor, Windsurf, VS Code | MCP stdio proxy (drop-in) |
| LangChain, CrewAI, AutoGPT, custom agents | HTTP sidecar API (~50 lines) |
pip install unwind-mcp gives you everything — pipeline, dashboard, Ghost Mode, CRAFT chain, rewind, CLI. One install.
The standalone packages below are for people who want just one piece:
| Package | What | Install |
|---|---|---|
| ghostmode | Dry-run proxy only (MIT, zero deps) | pip install ghostmode |
| craft-auth | Transport auth library only (zero deps) | pip install craft-auth && craft-auth demo |
UNWIND is built on a six-layer security model, from immediate enforcement to deep cryptographic attestation:
| Layer | What it does | Status |
|---|---|---|
| UNWIND | 15-stage enforcement pipeline, flight recorder, trust light | Operational |
| Rollback | File-level smart snapshots with one-command undo | Operational |
| Ghost Mode | Dry-run sandbox with shadow VFS | Operational |
| CRAFT | Transport-layer auth + tamper-evident hash chain | Operational |
| CADENCE | Temporal anomaly detection (timing-based) | Live prototype |
| CRIP | Consent protocol for rhythm data | Verify |
Full architecture → · Pipeline stages → · Threat model →
unwind serve -- <command> MCP stdio proxy
unwind status Trust state + recent events
unwind log [--since TIME] Event timeline
unwind verify Hash chain integrity check
unwind undo last|ID|--since Rollback actions
unwind dashboard Web UI
unwind ask "question" Natural language query
unwind export json|html Export events
unwind anchor Chain checkpoint
unwind tamper-check Tamper detection report
git clone https://github.com/unwind-mcp/unwind
cd unwind
pip install -e ".[dev]"
pytest # 1,859 testsContributing → · Security policy → · Changelog →
AGPL-3.0-or-later (Ghost Mode is MIT)
PyPI · Ghost Mode · CRAFT · Dashboard Demo · Architecture · Threat Model · Security Policy · Changelog


