Get the context right at your editor with a single command. Context Pilot helps you understand your codebase better by providing relevant context, commit history, and file relationships.
Features
Core Features
Feature
Description
Smart Indexing
Index your entire workspace or specific subdirectories
Context Files
Find related files based on current line, selection, or entire file
Commit History
View relevant commits and their descriptions
Auto Re-indexing
Automatically re-index changed files on Git commits
Cursor Chat Integration
Generate diffs for analysis in Cursor Chat
Commands
Command
Description
Shortcut
Context Pilot: Index Workspace
Index the entire workspace
-
Context Pilot: Re-index Changed Files
Re-index only files changed since last indexing
-
Context Pilot: Index Subdirectories
Index specific subdirectories
-
Context Pilot: Line Number
Get context files for current line
-
Context Pilot: Current File
Get context files for entire current file
-
Context Pilot: Get Context Files for Selected Range
Get context files for selected code
-
Context Pilot: Get Relevant Commits
View commit history for current code
-
Context Pilot: Generate Diffs for Cursor Chat
Generate diffs for Cursor Chat analysis
-
Installation
Install the extension from VS Code marketplace
Install the ContextPilot binary using one of these methods:
Download from GitHub releases and add to PATH
Install via cargo: cargo install contextpilot
Copy binary to one of these locations:
~/.local/bin/
~/.cargo/bin/
/usr/local/bin/
/usr/bin/
Configuration
Setting
Type
Default
Description
contextpilot.autoIndexOnGitCommit
boolean
true
Automatically trigger workspace indexing when a Git commit is made
Requirements
VS Code 1.79.0 or higher
ContextPilot binary version 0.9.0 or higher
Git repository (for commit history and auto-indexing features)
GitHub Copilot extension (for enhanced features)
Features in Detail
Smart Indexing
Full workspace indexing
Subdirectory-specific indexing
Automatic re-indexing of changed files
Progress tracking with status bar updates
Context Files
Find related files based on:
Current line
Selected code range
Entire file
Shows occurrence count for each related file
Commit History
View relevant commits for current code
Detailed commit information including:
Commit message
Author
Date
Commit URL
Interactive commit selection
Auto Re-indexing
Tracks last indexing time
Automatically re-indexes changed files on Git commits
Efficient partial re-indexing
Progress tracking with notifications
Cursor Chat Integration
Generate diffs for selected code
View commit history in markdown format
Analyze changes using Cursor Chat
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
