Skip to content

Commit e38c7bc

Browse files
dormsternclaude
andcommitted
docs: add "AI got hands" before/after flow diagram to README
Replace vertical mermaid flowchart with horizontal before/after diagrams showing the middleware concept. Add crane operator analogy, rule summary table, and link to behalf.work/shield showcase. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent f769a0b commit e38c7bc

1 file changed

Lines changed: 42 additions & 21 deletions

File tree

README.md

Lines changed: 42 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ Policy, audit, kill switch for any AI agent with access to your accounts.
88
[![license](https://img.shields.io/npm/l/declawed)](./LICENSE)
99
[![tests](https://img.shields.io/badge/tests-67%20passing-brightgreen)](#)
1010

11+
**[See the full showcase →](https://behalf-gray.vercel.app/shield/)**
12+
1113
### OpenClaw sales bot — declawed
1214

1315
![OpenClaw demo](docs/demos/openclaw-demo.gif)
@@ -155,38 +157,57 @@ Read records, update fields, search contacts — allowed. Bulk-delete, export pi
155157

156158
---
157159

158-
## How It Protects You
159-
160-
Your credentials live in AnchorBrowser, not in your code. Your agent never sees your password — it gets a scoped, ephemeral session, and declawed controls what it can do.
160+
## AI got hands. We control the grip.
161161

162-
**Three layers of protection:**
162+
Think of a crane operator. The brain decides what to move — but the joystick decides how far the arm can reach. **declawed is the joystick between the AI agent and your accounts.**
163163

164-
1. **Credential isolation** — your password stays in AnchorBrowser. The agent gets a pre-authenticated session, never the credentials themselves.
165-
2. **Scoped permissions** — the agent can only do what your policy allows. Read inbox? Yes. Delete contacts? Blocked. It can't go beyond the scope you define.
166-
3. **Audit + kill switch** — every action logged (allowed and blocked). Budget enforced. Instant session destruction when you're done.
164+
### Without declawed
167165

168166
```mermaid
169-
flowchart TD
170-
A["🔑 <b>One-time setup</b><br/>Create AnchorBrowser profile<br/>Log into LinkedIn / Gmail manually<br/>Auth saved — password never leaves AnchorBrowser"] --> D
167+
flowchart LR
168+
A["🤖 AI Agent<br/><i>the brain</i>"]
169+
B["📧 Your Accounts<br/><i>LinkedIn, Gmail, CRM</i>"]
171170
172-
D["🤖 Agent calls <b>shield.task</b>"] --> E{"🛡️ <b>declawed</b><br/>Policy check"}
171+
A -- "🔴 your password<br/>full access" --> B
173172
174-
E -->|"✅ Allowed"| F["☁️ <b>AnchorBrowser</b><br/>Ephemeral cloud session<br/>with your saved profile<br/>Already logged in"]
175-
E -->|"❌ Blocked"| G["🚫 <b>Stopped</b><br/>Agent never reaches<br/>your account"]
173+
style A fill:#fef2f2,stroke:#fca5a5,color:#991b1b
174+
style B fill:#fef2f2,stroke:#fca5a5,color:#991b1b
175+
```
176176

177-
F --> H["Task executes in<br/>isolated cloud browser"]
178-
H --> I["Result returned to agent"]
177+
> **The agent IS you.** Full access. No limits. No off switch.
178+
179+
### With declawed
180+
181+
```mermaid
182+
flowchart LR
183+
A["🤖 AI Agent<br/><i>the brain</i>"]
184+
S["🛡️ declawed<br/><i>the joystick</i>"]
185+
B["📧 Your Accounts<br/><i>LinkedIn, Gmail, CRM</i>"]
179186
180-
G --> J["📝 Every action logged"]
181-
I --> J
182-
J --> K["⏱️ Budget enforced<br/>🔴 Kill switch ready"]
187+
A -- "requests action" --> S
188+
S -- "🟢 scoped access" --> B
183189
184-
style A fill:#1565c0,color:#fff
185-
style E fill:#f57f17,color:#fff
186-
style F fill:#388e3c,color:#fff
187-
style G fill:#d32f2f,color:#fff
190+
style A fill:#f0fdf4,stroke:#86efac,color:#166534
191+
style S fill:#ede9fc,stroke:#6d5bd0,color:#6d5bd0
192+
style B fill:#f0fdf4,stroke:#86efac,color:#166534
188193
```
189194

195+
> **The agent works through controlled arms.** You decide what moves.
196+
197+
| | |
198+
|---|---|
199+
| ✅ read inbox | ✅ list messages |
200+
| ❌ delete data | ❌ export contacts |
201+
| ⏱️ 60 min limit | 🔢 50 actions max |
202+
203+
> *A crane operator doesn't carry the steel himself. He moves joysticks that control arms — limited to a work zone, every movement tracked, with an emergency stop within reach. That's what declawed does for AI agents.*
204+
205+
### Three layers of protection
206+
207+
1. **Credential isolation** — your password stays in an isolated cloud browser. The agent gets a pre-authenticated session, never the credentials themselves.
208+
2. **Scoped boundaries** — the agent can only do what your policy allows. Read inbox? Yes. Delete contacts? Blocked before it starts.
209+
3. **Audit + kill switch** — every action logged (allowed and blocked). Budget enforced. Instant session destruction when you're done.
210+
190211
## CLI
191212

192213
```bash

0 commit comments

Comments
 (0)