$git clone https://github.com/Houseofmvps/codesight4,000+ downloads and counting.
| 1 | <div align="center"> |
| 2 | |
| 3 | ### Your AI assistant wastes thousands of tokens every conversation just figuring out your project. codesight fixes that in one command. |
| 4 | |
| 5 | **4,000+ downloads and counting.** |
| 6 | |
| 7 | **Zero dependencies. AST precision. 30+ framework detectors. 14 ORM parsers. 14 MCP tools. One `npx` call.** |
| 8 | |
| 9 | **Works with TypeScript, JavaScript, Python, Go, Ruby, Elixir, Java, Kotlin, Rust, PHP, Dart, Swift, C#, and BrightScript/BrighterScript ( |
| 10 | Roku).** TypeScript projects get full AST precision. Everything else uses battle-tested regex detection across the same 30+ frameworks. |
| 11 | |
| 12 | [](https://www.npmjs.com/package/codesight) |
| 13 | [](https://www.npmjs.com/package/codesight) |
| 14 | [](https://www.npmjs.com/package/codesight) |
| 15 | [](https://github.com/Houseofmvps/codesight/stargazers) |
| 16 | [](LICENSE) |
| 17 | |
| 18 | --- |
| 19 | |
| 20 | [](https://x.com/kaileskkhumar) |
| 21 | [](https://www.linkedin.com/in/kailesk-khumar) |
| 22 | [](https://houseofmvps.com) |
| 23 | [](https://www.kailxlabs.co) |
| 24 | |
| 25 | **Built by [Kailesk Khumar](https://www.linkedin.com/in/kailesk-khumar), founder of [HouseofMVPs](https://houseofmvps.com) |
| 26 | and [Kailxlabs](https://www.kailxlabs.co)** |
| 27 | |
| 28 | *Also: [ultraship](https://github.com/Houseofmvps/ultraship) (39 expert skills for Claude |
| 29 | Code) · [claude-rank](https://github.com/Houseofmvps/claude-rank) (SEO/GEO/AEO plugin for Claude Code)* |
| 30 | |
| 31 | </div> |
| 32 | |
| 33 | --- |
| 34 | |
| 35 | ``` |
| 36 | 0 dependencies · Node.js >= 18 · 145 tests · 14 MCP tools · MIT · tested on 25+ OSS projects across 14 languages |
| 37 | ``` |
| 38 | |
| 39 | ## Works With |
| 40 | |
| 41 | **Claude Code, Cursor, GitHub Copilot, OpenAI Codex, Windsurf, Cline, Aider**, and anything that reads markdown. |
| 42 | |
| 43 | ## Install |
| 44 | |
| 45 | ```bash |
| 46 | npx codesight |
| 47 | ``` |
| 48 | |
| 49 | That's it. Run it in any project root. No config, no setup, no API keys. |
| 50 | |
| 51 | ```bash |
| 52 | npx codesight --wiki # Generate wiki knowledge base (.codesight/wiki/) |
| 53 | npx codesight --init # Generate CLAUDE.md, .cursorrules, codex.md, AGENTS.md |
| 54 | npx codesight --open # Open interactive HTML report in browser |
| 55 | npx codesight --mcp # Start as MCP server (14 tools) for Claude Code / Cursor |
| 56 | npx codesight --blast src/lib/db.ts # Show blast radius for a file |
| 57 | npx codesight --profile claude-code # Generate optimized config for a specific AI tool |
| 58 | npx codesight --benchmark # Show detailed token savings breakdown |
| 59 | npx codesight --native-ast # Opt-in: AST plugins for more languages (see docs/wasm-plugins.md) |
| 60 | npx codesight --mode knowledge # Map knowledge base (.md notes → KNOWLEDGE.md) |
| 61 | npx codesight --mode knowledge ~/vault # Map Obsidian vault, ADRs, meeting notes, retros |
| 62 | ``` |
| 63 | |
| 64 | ## Wiki Knowledge Base (v1.6.2) |
| 65 | |
| 66 | Inspired by [Karpathy's LLM wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) — but compiled from AST, not an |
| 67 | LLM. Zero API calls. 200ms. |
| 68 | |
| 69 | ```bash |
| 70 | npx codesight --wiki |
| 71 | ``` |
| 72 | |
| 73 | Generates `.codesight/wiki/` — a persistent knowledge base of your codebase that survives across every sessi |