Skip to content

VERTEX - Python Code Analysis

🚀 Real-time cross-file Python analysis with visual highlighting and dead code detection

🎯 Marketplace

📦 Install from VS Code Marketplace

⭐ Key Features

🎯 Real-time cross-file analysis - Understands your entire Python project
🎨 Visual code highlighting - See caller/callee relationships directly in your editor
⚡ Interactive navigation - Lock on functions and navigate with keyboard shortcuts
💀 Smart dead code detection - Find unused functions across your entire project
📊 Inline statistics - See caller/callee counts above each function

🚀 Quick Start

Install the extension from VS Code marketplace
Open any Python project
See CodeLens appear above your functions showing caller/callee counts
Click CodeLens to lock highlighting on a function
Use Alt+] and Alt+[ to navigate between callers

🎯 Key Features

Visual Code Relationships

Orange highlights: Lines that call your current function
Pink highlights: Functions called by your current function
Real-time updates as you navigate through code

Dead Code Detection

Project-wide analysis finds truly unused functions
Cross-file intelligence knows if functions are called from other files
Smart exclusions for entry points and special methods

Lock mode: Focus on one function's relationships
Keyboard shortcuts: Navigate quickly between related code
Cross-file navigation: Jump between files seamlessly

⌨️ Keyboard Shortcuts

Alt+] - Navigate to next caller
Alt+[ - Navigate to previous caller
Esc - Exit navigation mode
Ctrl+Shift+D (Windows/Linux) / Cmd+Shift+D (Mac) - Analyze dead code

🛠️ Commands

VERTEX: Analyze Dead Code (Project-wide) - Run manual dead code analysis across entire project
VERTEX: Test Backend Connection - Check if analysis server is running

Dead Code Analysis Behavior

Initial Analysis: Runs automatically 2 seconds after opening a workspace (if enabled in settings)
Manual Analysis: Use Ctrl+Shift+D or command palette to run on-demand
No Auto-refresh: Dead code analysis no longer runs on every keystroke for better performance

⚙️ Configuration

Customize VERTEX through VS Code settings:

vertex.showCallerHighlights - Show orange caller highlights

🐛 Known Limitations

Large projects (500+ files) may experience slower analysis
Some complex import patterns might not be fully resolved
Occasional file collection timing issues

📞 Support & Feedback

Issues: Report bugs at GitHub Issues
Questions: Open an issue with "question" label
Feature Requests: Open an issue with "enhancement" label

📄 License

MIT License - see LICENSE file for details.

Made with ❤️ for the Python community