Introduction
Mikk gives your AI real codebase intelligence — parsed AST, full dependency graph, Merkle hashing, and a live MCP server. Zero cloud. Zero hallucination.
Your AI doesn't understand your codebase. Mikk fixes that.
Mikk parses your entire project via the TypeScript Compiler API, builds a bidirectional dependency graph, hashes everything with Merkle-tree SHA-256, and serves it through an MCP server that Claude, Cursor, and VS Code Copilot call directly. Everything stays on your machine.
What is Mikk?
LLMs write great code — for codebases they've never seen. They don't know your module boundaries, can't trace your dependency graph, and have no idea that touching login.ts breaks 14 downstream functions across 3 packages.
Mikk fixes that by giving AI assistants real architectural intelligence — not guesses.
The 7-Step Pipeline
Everything happens in ~3 seconds when you run mikk init:
Parse
Every .ts, .tsx, .js, .jsx, .go file parsed via the TypeScript Compiler API — real AST, not regex. Functions, classes, imports, exact line ranges.
Graph
Full dependency DAG built in two passes. Both dependsOn and dependedOnBy maps — O(1) traversal in either direction.
Cluster
Files grouped into logical modules via greedy agglomeration — import patterns, naming conventions, directory structure.
Hash
SHA-256 Merkle tree at every level: function → file → module → root. One hash = full drift detection.
Contract
mikk.json written — module boundaries, constraint rules, and ADR decisions.
Context
claude.md + AGENTS.md generated — tiered architecture summaries, ready for any AI assistant.
Serve
MCP server starts. 18 tools, 3 resources, millisecond response times — all reading from mikk.lock.json.
Key Capabilities
AI Context Builder
BFS graph-traced, token-budgeted context payloads with exact file paths and line ranges.
Impact Analysis
Full blast radius of any file change — every upstream caller, every downstream dependency.
Intent Pre-flight
Validate a plain-English plan against 6 constraint types before writing a single line.
Strict Contracts
Define module boundaries in mikk.json. CI fails on violations.
MCP Server
18 tools, 3 resources. Works with Claude Desktop, Cursor, and VS Code Copilot.
Merkle Drift Detection
One root hash comparison = full codebase drift check. SQLite WAL mode for concurrent access.
Live Watcher
Incremental, debounced file watching. Atomic lock writes. PID singleton enforcement.
Full AST Parsing
TypeScript · TSX · JavaScript · JSX · Go. Compiler-grade parsing — no regex guessing.
Package Ecosystem
Mikk is a Turborepo monorepo with 8 npm packages under @getmikk:
| Package | Role |
|---|---|
| @getmikk/core | AST parsing, dependency graph, Merkle hashing, contract management |
| @getmikk/cli | 15+ commands — init, analyze, diff, watch, contracts, context, intent |
| @getmikk/ai-context | BFS graph tracing, token budgeting, claude.md generation |
| @getmikk/mcp-server | MCP server — 18 tools, 3 resources for AI assistants |
| @getmikk/intent-engine | NL prompt parsing, conflict detection (6 rule types) |
| @getmikk/watcher | Debounced incremental watcher, atomic updates |
| @getmikk/diagram-generator | Mermaid.js diagrams, 8 diagram types |
| @getmikk/vscode-extension | VS Code tree, impact analysis, AI context, status bar |
Next Steps
Installation & Quick Start
Get Mikk running in your project in under 3 minutes.
Core Concepts
Understand the Mesh, Merkle hashing, and the AI Context Builder.
MCP Server
Connect to Claude, Cursor, and VS Code Copilot.
CLI Reference
All 15+ commands with options and examples.
Was this page helpful?