BigSky Source Code Analysis
A VS Code extension that provides an MCP (Model Context Protocol) server for deep source code analysis of large projects (500k+ LOC).
Features
- Index any codebase — Java, TypeScript, Python, C#, Go, Rust, Kotlin and more
- Ask questions about code —
@bigsky /ask_codebase What does the AuthService do?
- Generate diagrams — PlantUML component, class, and sequence diagrams
- Architecture docs — Auto-generated README, module docs, onboarding guides
- Semantic search — TF-IDF vector index for intelligent code search
- Impact analysis — Find all callers/callees of any symbol
Requirements
- VS Code 1.99+
- Node.js 20+ installed on your machine
- An MCP-compatible AI client (GitHub Copilot Chat, Claude, etc.)
Quick Start
- Install the extension
- Open a workspace containing source code
- In Copilot Chat, use the MCP tools:
/index_repository output=./analysis_output
/ask_codebase What is the main entry point of this application?
/generate_plantuml type=component
| Tool |
Description |
index_repository |
Scan and index an entire codebase |
get_index_status |
Check indexing progress |
search_symbols |
Find classes, functions, types by name |
search_code |
Semantic search across all files |
get_file_summary |
Summarize a specific file |
get_module_summary |
Summarize a module/package |
generate_plantuml |
Generate PlantUML diagrams |
write_documentation |
Generate architecture/module docs |
MCP Prompts (Slash Commands)
| Prompt |
Description |
/ask_codebase |
Answer questions about the codebase |
/explain_feature |
Explain how a feature works |
/find_related_code |
Find code related to a topic |
/generate_sequence |
Sequence diagram for a flow |
/generate_class_diagram |
Class diagram for a module |
/write_architecture |
Full architecture document |
/write_module_doc |
Documentation for a module |
/impact_analysis |
Impact analysis for a symbol |
/debug_flow |
Debug a specific code flow |
/onboarding_guide |
Onboarding guide for new developers |
Commands
- BigSky Analysis: Show MCP Server Status — Show server status in a WebView panel
- BigSky Analysis: Open Documentation — Open the GitHub documentation
Configuration
The MCP server is automatically configured when the extension is installed. No manual setup required.
The server binary is bundled at ${extensionPath}/out/server.js.
Output
All analysis artifacts are written to the output directory you specify. Contents include:
manifest.json — Index metadataknowledge-base.md — Full codebase knowledge basedocs/architecture.md — Architecture overviewdocs/onboarding.md — Onboarding guidediagrams/*.puml — PlantUML diagram filessummaries/*.json — Per-file and per-module summaries
Troubleshooting
Extension not loading?
Check that Node.js 20+ is installed: node --version
MCP server not responding?
Run BigSky Analysis: Show MCP Server Status from the Command Palette.
Index failed?
Ensure the output directory is writable and not inside the source repository.
License
MIT — see LICENSE
Source
github.com/bigsky/bigsky_source_code_analysis
| |
