Proactive Claw

# 🦞 Proactive Claw

Proactive Claw is a **proactive execution engine** that **collaborates with you** and **learns from you**.

It helps you be more productive by making smart suggestions at the right moment — and (by default) only applying what you approve.

**Everything can run locally.**

---

## Safety in one glance ✅

✅ Asks before applying changes (default)  
✅ Writes only what you approve (no surprise calendar edits)  
✅ Local-first core bundle (no external integration helpers)  
✅ Everything can run locally (small/local scoring model recommended)  
✅ Local state folder is transparent and deletable  

---

## Why people install it (what you feel in week 1)

- You show up prepared more often.
- Your calendar becomes more realistic (buffers appear where they matter).
- Deep work blocks stop getting shredded by “just one quick meeting.”
- Follow-ups stop slipping.
- Proactive Claw learns your style quickly:
  prep durations, preferred times, what you reject, what you always accept.

In short: it becomes your personal assistant.

---

## Graph A — the simple loop (how it works at a glance)

```text
+--------------------------+        +--------------------------+
| Calendar                 |        | Chat                     |
| Google Calendar/Nextcloud|        | (your control loop)      |
+------------+-------------+        +------------+-------------+
             |  events <-> suggestions           | prompts <-> decisions
             |                                   |
             +-------------------+---------------+
                                 |
                                 v
                  +--------------------------------------+
                  |            Proactive Claw             |
                  |  - notices what's coming              |
                  |  - prioritizes what matters           |
                  |  - suggests prep / buffers / followup |
                  |  - learns from your feedback          |...