🚀 Quick Start (30 seconds)

Option 1: One-Line Setup

npx @kindly-software-inc/kdb configure --auto

Follow the prompts to sign in with Google and auto-configure your MCP client.

Option 2: With License Key

npx @kindly-software-inc/kdb configure --auto --license "YOUR-LICENSE-KEY"

Option 3: Install with Auto-Configure

npm install @kindly-software-inc/kdb

If you have KDB_LICENSE_KEY set or a license file at ~/.config/kdb/license.key, the installer automatically configures your MCP client.

To disable auto-configure during install:

KDB_SKIP_AUTO_CONFIGURE=true npm install @kindly-software-inc/kdb

Option 4: Manual Config

Add to your ~/.claude.json (Claude Code) or MCP client config:

{
  "mcpServers": {
    "kdb": {
      "command": "npx",
      "args": ["-y", "@kindly-software-inc/kdb"],
      "env": {
        "KDB_LICENSE_KEY": "YOUR-LICENSE-KEY"
      }
    }
  }
}

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 →

🛠️ 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
• 📖 Documentation
• 💬 Discord (coming soon)

📋 Version History

v2.3.0 (Current)

• Simplified npx - Now just npx @kindly-software-inc/kdb (no -p flag needed)
• Auto-configure on install - npm install auto-configures if license detected
• Skip auto-configure - Set KDB_SKIP_AUTO_CONFIGURE=true to disable

v2.2.6

• Critical Fix - Claude Code config now writes to ~/.claude.json (not ~/.config/claude-code/mcp.json)
• OAuth Landing - Added manual MCP config fallback with copy button
• Auto-downloads - License file downloads immediately, script downloads removed (unreliable)
• Binary sizes - 2.2MB client, 2.4MB configure (stripped, with P0 protection)

v2.2.5

• 📝 Updated README - New lean branding with purple/gold theme
• 🖼️ New logo - Transparent PNG with rounded corners

v2.2.4

• 🖱️ One-click terminal setup - Click kdb:// link, terminal opens automatically
• ⚡ Zero-command setup - Browser → Terminal → Press Y → Done!
• ✅ Enhanced scripts - Y/N prompts, progress spinners, prerequisite checks

v2.1.0

• Auto-configuration - npx @kindly-software-inc/kdb configure --auto
• Auto-detection - Claude Code, Cursor, VS Code, 90+ MCP clients
• Safe backups - Creates backups before modifying
• Rollback - Restore previous configs anytime

v2.0.0

• ⚡ Retry with backoff - 5 attempts, exponential backoff
• 🔄 Circuit breaker - 99.9% uptime
• 🚀 Response caching - 100× faster
• 🎯 Request deduplication - <30ns duplicate check
• 💾 Offline mode - Queue 100 requests
• 🛡️ Binary hardening - Multi-layer protection