noodles

I built a CLI tool that turns codebases and PRs into diagrams so you can quickly understand how things fit together. Originally made it because I couldn't follow my own AI-generated repos. Just shipped a big update: - Switched from D2 to Mermaid for rendering - Tree-sitter AST parsing + agentic flow instead of raw LLM calls. ~50x faster. - Works on any GitHub repo or PR, not just local - Dropped the web frontend, it's just a CLI now - Published as a pip package Still a ton to improve and I'm building fast. Feedback, issues, PRs all welcome.

I built Noodles to help me keep up with the codebases my AI tools generate. Open sourced last week, hit 400 stars in 8 days. The problem: AI assistants scaffold entire features quickly, but leave you maintaining code you didn't write. When bugs appear, you're reverse-engineering your own project. Noodles generates interactive D2 diagrams showing execution flow: - Scans the repository and identifies entry points (CLI commands, routes, UI components) - Maps how execution flows from entry to outcome - Renders interactive overlays with clickable nodes and tooltips - Updates incrementally when code changes Technical limitations: - Performance degrades beyond ~100 files - Diagram quality varies by codebase structure - UI is minimal GitHub: https://github.com/unslop-xyz/noodles Feedback welcome!

This is a really cool project, and incredible traction - great job! I can see how this would work well with Claude Code to quickly explain what's going on. I've worked on a similar project, but instead of going the ASCII route, we decided to lean into interactivity for code exploration. The angle is more around empowering human understanding, instead of agent understanding. We also chose D2 (and are looking to support Mermaid soon too). Would love to hear others' thoughts on whether interactivity for humans is more valuable vs context for agents. https://github.com/unslop-xyz/noodles