<p align="center">
  <img src="kdb_transparent.png" alt="Kindly Debugger" width="120" height="120" style="border-radius: 50%"/>
</p>

<h1 align="center">✨ KDB - The Kindly Debugger ✨</h1>

<p align="center">
  <strong>Give your AI the superpower of <span style="color: #FFD700;">traveling back in time</span> to find what went wrong and fix the timeline.</strong>
</p>

<p align="center">
  <a href="https://www.kindly.software">🌐 Website</a> •
  <a href="https://www.kindly.software/#signup">🎉 Start Free</a> •
  <a href="https://www.kindly.software/#docs">📖 Docs</a>
</p>

---

## 🚀 Quick Start (30 seconds)

### Option 1: One-Line Setup
```bash
npx -p @kindly-software-inc/kdb kdb-configure --auto
```
Follow the prompts to sign in with Google and auto-configure your MCP client.

### Option 2: With License Key
```bash
npx -p @kindly-software-inc/kdb kdb-configure --auto --license "YOUR-LICENSE-KEY"
```

### Option 3: Manual Config
Add to your MCP client config (Claude Code, Cursor, etc.):
```json
{
  "mcpServers": {
    "kdb": {
      "command": "npx",
      "args": ["@kindly-software-inc/kdb"]
    }
  }
}
```

**That's it!** 🎊 Ask your AI: *"Debug my crashing program"*

---

## ⏱️ What It Does

**Time-travel debugging for AI workflows.** Step forward. Step backward. Debug as if the bug never existed.

| Feature | Description |
|---------|-------------|
| ⏪ **Step Backward** | Rewind execution to find root causes |
| ⏩ **Step Forward** | Resume from any checkpoint |
| 🎯 **Breakpoints** | Hardware-level with hit counting |
| 📚 **Stack Traces** | SIMD-accelerated unwinding |
| 🔐 **Audit Trail** | Hash-chain integrity for compliance |

---

## 💜 How It Works

```
┌─────────────────┐     MCP      ┌─────────────────┐
│  Your Machine   │◄────────────►│  Kindly Server  │
│  (any OS)       │              │  (Linux x86_64) │
│                 │              │                 │
│  Claude Code    │              │  🔮 Time-Travel │
│  Cursor         │              │  🎯 Breakpoints │
│  Any AI         │              │  📊 Analysis    │
└─────────────────┘              └─────────────────┘
```

**No local installation.** Works on macOS, Windows, Linux via MCP.

---

## 🏷️ Pricing

| Tier | Price | Sessions |
|------|-------|----------|
| 🆓 **Hobby** | Free | 5/month (unlimited during 7-day trial!) |
| 💎 **Pro** | $19/mo | 100/month + unlimited time-travel |
| 🔧 **Engineer** | $49/mo | 500/month + memory replay + LSH bug search |
| 👥 **Teams** | $129/mo | 2,000/month + team audit logs |
| 🏢 **Enterprise** | Custom | Unlimited + SOX/SOC2/GDPR/HIPAA compliance |

**[Start Free →](https://www.kindly.software/#signup)**

---

## 🛠️ MCP Tools

Your AI gets these debugging superpowers:

- `debugger_attach` - Connect to a process
- `debugger_set_breakpoint` - Set breakpoints
- `debugger_continue` - Resume execution
- `debugger_step_forward` - Step forward
- `debugger_step_backward` - ⏪ Step backward in time
- `debugger_get_stack_trace` - Get stack trace
- `debugger_get_variables` - Read memory
- `debugger_export_trace` - Export execution trace

---

## 💬 Example

**You:** "My Rust program crashes at runtime. PID is 12345"

**AI:**
```
I'll attach and debug that for you.

📎 Attached to process 12345
📸 Captured snapshot
🔍 Stack trace shows crash at unwrap() on None in process_data()

The issue is at line 47 in src/main.rs. Here's the fix:
[code suggestion]
```

---

## 📞 Support

- 🌐 [kindly.software](https://www.kindly.software)
- 📖 [Documentation](https://www.kindly.software/#docs)
- 💬 [Discord](https://discord.gg/kindly) *(coming soon)*

---

<p align="center">
  <strong>Built with 💜 by <a href="https://www.kindly.software">Kindly Software</a></strong>
</p>