Skip to content

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 20 Jul 05:18
· 68 commits to main since this release

🔍 Library Insight v1.0.0

Library Insight is a bytecode-driven command-line tool designed to inspect, analyze, and index compiled Java & Kotlin libraries (JARs, AARs, or Maven coordinates) directly without requiring source code.


✨ Key Features & Capabilities

  • 📦 Bytecode & Metadata Extraction: Parses .class bytecode using ASM and decodes Kotlin @Metadata annotations using kotlin-metadata-jvm across JARs, AARs, and Gradle build outputs.
  • Offline-First Gradle Caching: Automatically checks local Gradle module caches (~/.gradle/caches/modules-2/files-2.1/) before fetching from repositories, enabling zero-copy, fully offline scans.
  • 🔍 Symbol Search (search): Fast, case-insensitive lookup across packages, classes, interfaces, methods, constructors, and properties.
  • 📖 API Inspector (explain): Detailed inspection of class structures, modifiers, extension receivers, suspend/inline flags, and Javadocs.
  • 🔄 Semantic Version Diffing (diff): Compares two library archives to detect binary breaking changes (deleted methods, visibility reductions, changed modifiers).
  • 🤖 Token-Efficient AI Context Export (ai-export): Splits the extracted API database into small per-class JSON files (build/ai-context/), reducing LLM context window bloat by up to 95% for coding assistants (Cursor, Gemini, Claude, Copilot).
  • 🩺 Diagnostics Engine (doctor): System diagnostic health checks for JRE 17+ environments, local cache status, and global AI agent skill configurations.

🚀 Quick Installation

Install globally on macOS / Linux with zero Node.js / npm dependencies:

curl -fsSL https://raw.githubusercontent.com/Coding-Meet/Library-Insight/main/install.sh | bash

⚡ Getting Started Workflow

# 1. Initialize workspace AI agent skill
library-insight init

# 2. Scan a dependency from Maven Central
library-insight scan com.squareup.retrofit2:retrofit:2.11.0

# 3. Search symbols in local index
library-insight search Retrofit

# 4. Inspect class signatures & Javadocs
library-insight explain Retrofit