KDB - The Kindly Debugger ✨

1<p align="center">
2  <img src="kdb_transparent.png" alt="Kindly Debugger" width="120" height="120" style="border-radius: 50%"/>
3</p>
4 
5<h1 align="center">✨ KDB - The Kindly Debugger ✨</h1>
6 
7<p align="center">
8  <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>
9</p>
10 
11<p align="center">
12  <a href="https://www.kindly.software">🌐 Website</a> •
13  <a href="https://www.kindly.software/#signup">🎉 Start Free</a> •
14  <a href="https://www.kindly.software/#docs">📖 Docs</a>
15</p>
16 
17---
18 
19## 🚀 Quick Start (30 seconds)
20 
21### Option 1: One-Line Setup
22```bash
23npx -p @kindly-software-inc/kdb kdb-configure --auto
24```
25Follow the prompts to sign in with Google and auto-configure your MCP client.
26 
27### Option 2: With License Key
28```bash
29npx -p @kindly-software-inc/kdb kdb-configure --auto --license "YOUR-LICENSE-KEY"
30```
31 
32### Option 3: Manual Config
33Add to your MCP client config (Claude Code, Cursor, etc.):
34```json
35{
36  "mcpServers": {
37    "kdb": {
38      "command": "npx",
39      "args": ["@kindly-software-inc/kdb"]
40    }
41  }
42}
43```
44 
45**That's it!** 🎊 Ask your AI: *"Debug my crashing program"*
46 
47---
48 
49## ⏱️ What It Does
50 
51**Time-travel debugging for AI workflows.** Step forward. Step backward. Debug as if the bug never existed.
52 
53| Feature | Description |
54|---------|-------------|
55| ⏪ **Step Backward** | Rewind execution to find root causes |
56| ⏩ **Step Forward** | Resume from any checkpoint |
57| 🎯 **Breakpoints** | Hardware-level with hit counting |
58| 📚 **Stack Traces** | SIMD-accelerated unwinding |
59| 🔐 **Audit Trail** | Hash-chain integrity for compliance |
60 
61---
62 
63## 💜 How It Works
64 
65```
66┌─────────────────┐     MCP      ┌─────────────────┐
67│  Your Machine   │◄────────────►│  Kindly Server  │
68│  (any OS)       │              │  (Linux x86_64) │
69│                 │              │                 │
70│  Claude Code    │              │  🔮 Time-Travel │
71│  Cursor         │              │  🎯 Breakpoints │
72│  Any AI         │              │  📊 Analysis    │
73└─────────────────┘              └─────────────────┘
74```
75 
76**No local installation.** Works on macOS, Windows, Linux via MCP.
77 
78---
79 
80## 🏷️ Pricing
81 
82| Tier | Price | Sessions |
83|------|-------|----------|
84| 🆓 **Hobby** | Free | 5/month (unlimited during 7-day trial!) |
85| 💎 **Pro** | $19/mo | 100/month + unlimited time-travel |
86| 🔧 **Engineer** | $49/mo | 500/month + memory replay + LSH bug search |
87| 👥 **Teams** | $129/mo | 2,000/month + team audit logs |
88| 🏢 **Enterprise** | Custom | Unlimited + SOX/SOC2/GDPR/HIPAA compliance |
89 
90**[Start Free →](https://www.kindly.software/#signup)**
91 
92---
93 
94## 🛠️ MCP Tools
95 
96Your AI gets these debugging superpowers:
97 
98- `debugger_attach` - Connect to a process
99- `debugger_set_breakpoint` - Set breakpoints
100- `debugger_continue` - Resume execution
101- `debugger_step_forward` - Step forward
102- `debugger_step_backward` - ⏪ Step backward in time
103- `debugger_get_stack_trace` - Get stack trace
104- `debugger_get_variables` - Read memory
105- `debugger_export_trace` - Export execution trace
106 
107---
108 
109## 💬 Example
110 
111**You:** "My Rust program crashes at runtime. PID is 12345"
112 
113**AI:**
114```
115I'll attach and debug that for you.
116 
117📎 Attached to process 12345
118📸 Captured snapshot
119🔍 Stack trace shows crash at unwrap() on None in process_data()
120 
121The issue is at line 47 in src/main.rs. Here's the fix:
122[code suggestion]
123```
124 
125---
126 
127## 📞 Support
128 
129- 🌐 [kindly.software](https://www.kindly.software)
130- 📖 [Documentation](https://www.kindly.software/#docs)
131- 💬 [Discord](https://discord.gg/kindly) *(coming soon)*
132 
133---
134 
135<p align="center">
136  <strong>Built with 💜 by <a href="https://www.kindly.software">Kindly Software</a></strong>
137</p>
138