codeglass

Code intelligence engine — extract symbols, references, import graphs, call graphs, type hierarchies, and structural outlines from codebases using tree-sitter.

Language-agnostic core with per-language plugins. 7 languages supported out of the box.

Quick Start

pip install codeglass

from pylens import CodeLens

lens = CodeLens()

# Get all symbols from a file
outline = lens.get_symbols("src/main.py")
for sym in outline.symbols:
    print(f"{sym.kind:10} {sym.name:30} line {sym.line}")

# Get the import graph of a project
graph = lens.get_import_graph("src/")
print(f"{graph.stats.total_files} files, {graph.stats.total_imports} imports")

# Find what a function calls
calls = lens.get_call_graph("handle_request", "src/server.py", 42)
for callee in calls.callees:
    print(f"  → {callee.name} (line {callee.resolved_line})")

# Get the class hierarchy
hierarchy = lens.get_type_hierarchy("src/")
for name, node in hierarchy.types.items():
    if node.subclasses:
        print(f"{name} → {', '.join(node.subclasses)}")

Features

Supported Languages

Python, JavaScript, TypeScript, Go, Rust, C/C++, Ruby

Adding a new language takes ~30 lines of tree-sitter queries.

Documentation

• Getting Started
• Operations Guide
• Languages
• API Reference

Requirements

• Python 3.11+
• tree-sitter 0.20.x
• tree-sitter-languages 1.10+

License

MIT