☕ Kadak-CLI

The Execution-Traced Coding Agent.
Deliver the best coding output per token.

Kadak-CLI is a specialized tool that uses precision execution tracing to minimize context and maximize surgical accuracy. Instead of reading your entire repository, Kadak "watches" your code run and identifies the exact "Live Wire" (executed lines) to provide the most high-signal context to the LLM.

🚀 Quick Start

1. Install Globally

npm install -g kadak-cli

2. Set Your API Key

export GEMINI_API_KEY="your-key-here"
# Optional: set your preferred model
export KADAK_MODEL="gemini-1.5-flash"

3. Enter the Autonomous REPL

Just run kadak in your project root to start the interactive, ledger-backed agent:

kadak

☕ The "Gold" Workflow: Trace & Fix

Never just ask to "fix a bug." Let Kadak watch it happen.

Step A: Trace the bug

kadak trace --cmd "npm test"

Step B: Apply the surgical fix

kadak fix "Fix the calculation error in cart.ts" --cmd "npm test"

🛠 Features

• The "Live Wire": precision context using the V8 Profiler.
• Persistent Ledger: Agent remembers previous tasks and learns from failures.
• Surgical Packing: Hunk-based prompts that save ~80% of tokens compared to naive agents.
• Autonomous Verification: Agent re-runs tests automatically to verify its own fixes.
• Git Safety: Automatic checkpoints and rollback options for every edit.

🏁 Roadmap

All 7 phases of the core mission are complete. We are now in the optimization phase, bringing precision tracing to every developer's toolkit.

Built with ☕ in India. Stay Kadak.