⚡ KA-CHOW

Living knowledge graph for your engineering system.

Scan any codebase and get an interactive architecture dashboard — dependency graph, health scores, impact analysis, and AI-powered insights — all in your browser.

Quick Start

npx kachow init

That's it. KA-CHOW will:

1. 🔑 Ask for your API keys (Anthropic required, others optional)
2. 🔍 Auto-detect and scan your repositories
3. 🚀 Start a local server with an interactive dashboard
4. 🌐 Open your browser at http://localhost:3000

What You Get

• Interactive Knowledge Graph — Visualize every service, dependency, and data flow
• Health Scores — Per-service health with latency, error rate, and coverage metrics
• Impact Analysis — "What breaks if I change this?" with blast radius visualization
• AI Q&A Terminal — Ask questions about your architecture in natural language
• Self-Healing Suggestions — AI-detected issues with one-click fix proposals
• Architecture Blueprints — Per-service compliance reports against your standards
• Manager Dashboard — Team onboarding, critical issues, and deployment overview

Commands

kachow init              # Full setup: credentials → scan → dashboard
kachow serve             # Start server without re-scanning
kachow scan -p ./path    # Scan a specific repo
kachow health            # Print system health summary
kachow reset --force     # Wipe local data and start fresh

Requirements

• Node.js 18+
• Anthropic API key (for AI features — get one at console.anthropic.com)

Optional: GitHub token (for private repos), OpenAI key (alternate models), Slack/Jira tokens (integrations).

How It Works

KA-CHOW scans your codebase to build a knowledge graph:

• Detects services, packages, and modules
• Maps imports, API calls, and data flows into dependency edges
• Scores health based on test coverage, documentation, error handling, and more
• Stores everything in a local SQLite database (.kachow/kachow.db)

No data ever leaves your machine unless you explicitly configure cloud integrations.

Configuration

Create a kachow.config.yaml in your project root (auto-generated on first init):

version: 1
project:
  name: "My Platform"
repos:
  - name: api-service
    path: ./services/api
    language: typescript
standards:
  require_readme: true
  min_test_coverage: 70

License

MIT