hce

Index multi-language codebases into hypergraphs for structural queries and HTML visualizations.

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/denson/hypergraph_code_explorer --skill hce
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hce
Source: https://github.com/denson/hypergraph_code_explorer/tree/main/skill
Command: npx skills add https://github.com/denson/hypergraph_code_explorer --skill hce

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Large or mixed-language codebases are hard to explore and reason about by reading files or feeding many sources to an LLM. HCE solves this by parsing code into a deterministic AST-backed hypergraph so structural questions (callers, inheritance, blast radius, subsystem boundaries) can be answered in milliseconds without costly token usage.

Core Features & Use Cases

  • Multi-language indexing: parses Python, JavaScript/TypeScript, Go, Rust, Java, C/C++, Ruby, and PHP (with regex fallbacks for others) into a single hypergraph index.
  • Fast structural queries: run targeted lookups, searches, blast-radius impact analyses, and overview/hub discovery without reading all source files.
  • Guided investigations & tours: accumulate evidence-backed tours for architecture explanations, onboarding, or incident impact analysis and render them into interactive D3 visualizations.
  • Visualization pipeline: export compact graph JSON and generate a self-contained HTML with precomputed layouts, color palettes, and tour-driven spotlighting.

Quick Start

Install HCE, index your project's source root with skip-summaries, and run the visualize command to produce an interactive HTML visualization.

Frequently Asked Questions about hce

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I visualize code architecture and dependencies across a mixed-language repository?

You can visualize code architecture by indexing a mixed-language repository into a hypergraph and generating a self-contained HTML visualization. This parses multiple languages into a single graph, enabling interactive structural exploration without reading source files.

What is blast-radius impact analysis and how does it work for code changes?

Blast-radius impact analysis identifies all components affected by a code change by querying a prebuilt hypergraph index. It traces callers and dependencies across the codebase in milliseconds, avoiding the token cost of feeding many source files to an LLM.

Can I index and query a codebase that uses Python, Go, and TypeScript together?

Yes, multi-language indexing supports Python, JavaScript/TypeScript, Go, Rust, Java, C/C++, Ruby, and PHP. It parses mixed-language repositories into a single deterministic hypergraph index using tree-sitter extraction, with regex fallbacks for unsupported languages.

How do I generate interactive D3 visualizations for codebase onboarding tours?

Generate interactive visualizations by accumulating evidence-backed tours for architecture explanations and exporting them as compact graph JSON. The pipeline produces self-contained HTML files with precomputed layouts, color palettes, and tour-driven spotlighting.

What is the best way to explore subsystem boundaries without consuming excessive LLM tokens?

Parsing code into an AST-backed hypergraph is the best way to explore subsystem boundaries without high token usage. It answers structural queries like inheritance and caller lookups in milliseconds directly from a cached index, bypassing costly LLM context windows.

Does code visualization work for repositories with languages outside the primary tree-sitter support?

Yes, the indexing pipeline includes regex fallbacks for languages outside its native tree-sitter support. This ensures unsupported file types are still incorporated into the hypergraph index for broader dependency tracing and structural queries.