{"slug": "show-hn-pviz-parser-codebase-parsing-package-for-python-and-ts-js-codebases", "title": "Show HN: Pviz-parser – codebase parsing package for Python and TS/JS codebases", "summary": "Pviz-parser, a new open-source codebase parsing package, generates structured JSON bundles of dependency analysis for Python and TypeScript/JavaScript projects. The tool analyzes dependency graphs, detects cycles, and produces compressed artifacts designed to fit within LLM context windows for direct upload to AI assistants like Claude and ChatGPT.", "body_md": "Generate LLM-optimized dependency analysis bundles from your codebase.\n\n`pviz-parser`\n\nanalyzes your project's dependency graph and produces a structured JSON bundle designed to fit inside an LLM context window. Instead of pasting files one by one, you give your LLM a complete picture of how your codebase is wired — nodes, edges, import relationships, cycle detection, and per-file metrics — in a single compressed artifact.\n\n```\npip install pviz-parser\npviz . -o bundle.json --clean\n```\n\nThat's it. Point `pviz`\n\nat your project root, specify an output path, and get a bundle ready to drop into Claude, ChatGPT, or any LLM that accepts file uploads or large context.\n\n```\npviz <scan_root> -o <output.json> [options]\n\nArguments:\n  scan_root             Root directory of the project to analyze\n\nOptions:\n  -o, --output          Output path for the bundle JSON (required)\n  --clean               Nuke the artifact cache before running (recommended when switching repos)\n  --store-root PATH     Override the sandbox directory (default: per-user .pviz_store)\n  --mode classic|zones  Build mode (default: zones)\n  --max-bytes N         Per-file size limit in bytes (default: 100MB)\n  --allow-output-in-repo  Allow writing the bundle inside scan_root\n# Analyze current directory\npviz . -o bundle.json --clean\n\n# Analyze a specific project\npviz ~/projects/myapp -o ~/Desktop/myapp_bundle.json --clean\n\n# Use a custom store root to keep artifacts organized\npviz . -o bundle.json --store-root /tmp/pviz --clean\n```\n\nThe output is a structured JSON artifact with:\n\n**Nodes**— one per source file, with LOC, SLOC, import/exporter counts, SCC membership, symbols, and language** Edges**— directed import relationships between files** Dependency metrics**— which files are most imported, which import the most, hotspots** Cycle detection**— strongly connected components (SCCs) flagged at the node level** Discovery manifest**— full file inventory with language breakdown** Folder index**— per-file import surface and resolution data** Summary**— counts, parse status, edge stats, crosstalk candidates\n\nA compressed format is also generated alongside the standard bundle (`.compressed.json`\n\n), typically 55–65% smaller, optimized for tight context windows.\n\n| Language | CLI (this package) | SaaS (\n|\n|---|\n\nKotlin, Go, and Rust analysis requires compiled binary dependencies that are part of the hosted SaaS only. Polyglot repos with multiple supported languages are handled automatically — the bundle merges all detected languages into a single artifact.\n\n`pviz-parser`\n\nis the open source CLI. It runs locally, produces bundles you own, and supports Python, TypeScript, JavaScript, and partial resolution for Java out of the box.\n\n[pvizgenerator.com](https://pvizgenerator.com) is the hosted SaaS layer. It adds full Kotlin, Go, and Rust support, hosted bundle storage, bundle diffing across commits, and MCP delivery for direct LLM tool integration — without running anything locally.\n\n- Python 3.10+\n- No other system dependencies for Python/TS/JS/partial-Java analysis\n\nMIT — see [LICENSE](/mikebmac86/pviz-parser/blob/main/LICENSE)\n\nBuilt by [Michael McClellan](https://pvizgenerator.com)", "url": "https://wpnews.pro/news/show-hn-pviz-parser-codebase-parsing-package-for-python-and-ts-js-codebases", "canonical_source": "https://github.com/mikebmac86/pviz-parser", "published_at": "2026-05-26 12:16:56+00:00", "updated_at": "2026-05-26 12:38:18.910119+00:00", "lang": "en", "topics": ["ai-tools", "ai-infrastructure", "large-language-models"], "entities": ["pviz-parser", "Claude", "ChatGPT"], "alternates": {"html": "https://wpnews.pro/news/show-hn-pviz-parser-codebase-parsing-package-for-python-and-ts-js-codebases", "markdown": "https://wpnews.pro/news/show-hn-pviz-parser-codebase-parsing-package-for-python-and-ts-js-codebases.md", "text": "https://wpnews.pro/news/show-hn-pviz-parser-codebase-parsing-package-for-python-and-ts-js-codebases.txt", "jsonld": "https://wpnews.pro/news/show-hn-pviz-parser-codebase-parsing-package-for-python-and-ts-js-codebases.jsonld"}}