teamxray

Team X-Ray is a VS Code extension that leverages GitHub data and, optionally, the Model Context Protocol (MCP) to reveal who knows specific files, how teammates collaborate, and where expertise lies within the codebase. When MCP integration is available, the extension can offload heavy analysis to an MCP server for deeper, scalable insights; otherwise it falls back to local analysis that examines commit history, contributor patterns, and AI-assisted interpretations. Use the extension’s context menu and command palette to discover experts for a file, analyze repository expertise, and view a team-wide expertise overview. If you enable the GitHub token, the AI-powered insights (powered by the GitHub Models API) become more accurate and responsive.

You can access these capabilities via:

• Right-click on a file in the explorer and choose "Team X-Ray: Find Expert for This File" to see who has the strongest knowledge of that file.
• Open the Command Palette and run "Team X-Ray: Analyze Repository Expertise" to get a holistic view of contributor patterns and areas of strength.
• Use "Team X-Ray: Show Team Expertise Overview" to display an at-a-glance summary of collaboration styles and expertise by team members.

Prerequisites:

• Node.js 20+ (recommended) and npm
• Git installed
• Visual Studio Code

installation options:

From Marketplace:

1. Open VS Code. Go to Extensions (Ctrl/Cmd+Shift+X).
2. Search for "Team X-Ray" (AndreaGriffiths11.teamxray).
3. Install and reload VS Code.

From source:

1. git clone https://github.com/AndreaGriffiths11/teamxray.git
2. cd teamxray
3. npm install
4. npm run compile (if available in repo) to build extension assets
5. Open the project in VS Code and press F5 to run the Extension Development Host for testing

Configure GitHub token (optional but recommended):

• In VS Code, run the command palette item "Team X-Ray: Set GitHub Token" and provide your token, or
• Set it in your shell: export GITHUB_TOKEN="your_github_token_here"

Notes and tips:

• MCP integration is optional; if an MCP server is not available, the extension performs local analysis using commit data and, optionally, AI-assisted insights via the GitHub Models API.
• To maximize AI insights, obtain and provide a GitHub token with appropriate scopes.
• If you plan to use MCP, ensure the MCP server is reachable and compatible with the required protocol version.
• Environment variables recommended: GITHUB_TOKEN (for AI insights), MCP_SERVER_URL if you host a custom MCP server, and any additional server-specific configuration your MCP deployment requires.
• If you encounter UI or performance issues, check the changelog or release notes for version-specific fixes in v1.0.5 or later.