Skip to content

devbgv/skelecode

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Skelecode

Code structure scanner that generates project-wide context graphs for humans and AI.

Note

Stable Release v1.0.0 — All core phases (1-12) are completed.

Skelecode scans your source code and produces a compact structural representation, preserving types, methods, and call relationships while stripping implementation details. Perfect for giving LLMs project-wide context without hitting token limits.

✨ Features

  • 🖥️ Interactive TUI — Browse modules, types, and methods with live Obsidian Preview.
  • 🦀 Multi-language Support — Built-in parsers for Rust, Java, Kotlin, JavaScript, TypeScript, and Python.
  • 🕵️ Symbol Search — Real-time TUI jump-to-symbol with live filtering and highlighting.
  • 🕸️ Advanced Call Graph — Heuristic call resolution (Level 1 & 2) and Reverse Call Graphs (Phase 10).
  • 🤖 AI-Ready Output — Export "Machine Context" format optimized for LLMs.
  • 📂 Obsidian Vault — Generate an interactive knowledge graph with rich Dataview metadata.
  • 🚀 Performance — Fast, tree-sitter based analysis with builtin exclusion for build artifacts.

🚀 Quick Start

# Clone and build
git clone https://github.com/gianglaodai/skelecode.git
cd skelecode
cargo build --release

# Launch TUI to scan a project
./target/release/skelecode /path/to/your/project

⌨️ TUI Keybindings

Key Action
Enter / l / Expand node / Toggle details
h / Collapse node / Jump to parent
/ Symbol Search (live filter)
Tab Switch between Machine Context & Obsidian Preview
y Copy current detail panel to clipboard
u / d Scroll detail panel up/down
e Open Export Overlay
b / Esc Back to Welcome Screen
q Quit

📖 Documentation

Detailed documentation is available in the docs/ folder:

  • README — Overview, installation, and TUI guide.
  • CLI Usage — Command-line arguments and non-interactive mode.
  • Architecture — Internals, Unified IR, and Parser design.
  • Output Formats — Obsidian Vault and Machine Context specifications.

🛠️ Built With

  • Tree-sitter — High-performance parsing.
  • Ratatui — Interactive terminal interface.
  • Clap — Robust CLI argument handling.

License: MIT

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Rust 100.0%