Noodles addresses the challenge of understanding AI-generated codebases by automatically creating interactive diagrams that visualize code execution flow. It helps developers quickly grasp the structure and behavior of AI-produced software without exhaustive line-by-line review, offering an intuitive comprehension path for codebases where logic might be unclear.

How It Works

The tool scans a project folder to build a code manifest. It uses OpenAI to identify user-facing entry points (CLI commands, routes, UI components) and generates D2 diagrams mapping execution flow from entry to outcome. An interactive overlay allows dynamic exploration. A key feature is incremental diagram updates, avoiding full rebuilds when code changes.

Quick Start & Requirements

• Installation: Recommended: uv sync. Alternative: pip install -e '.[dev]'.
• Prerequisites: Python 3.9+, uv/pip, d2 CLI, OpenAI API key.
• d2 CLI: Install via brew install d2 (macOS) or download from https://d2lang.com.
• OpenAI API Key: Configure via .env file (OPENAI_API_KEY=your-key) or environment variable.
• Usage: Run with unslop run. Optional: set UNSLOP_D2_BIN path or UNSLOP_LOG_LEVEL.

Highlighted Details

• Interactive diagrams visualize code flow from identified entry points.
• Incremental diagram updates track code changes efficiently.
• Employs OpenAI to automatically detect user-facing code components.

Maintenance & Community

No specific details regarding contributors, community channels, sponsorships, or roadmap information were found in the provided README excerpt.

Licensing & Compatibility

The README does not specify the project's license type or provide compatibility notes for commercial use or linking within closed-source projects.

Limitations & Caveats

Performance is optimized for projects under 100 files. The UI is intentionally verbose for debugging, with simplification planned. Diagram quality may vary, as prompt tuning is ongoing.