https://github.com/andreagriffiths11/teamxray
Human discovery through code analysis - VS Code extension that reveals team expertise.
https://github.com/andreagriffiths11/teamxray
azure-devops chatgpt github github-models mcp-server vscode vscode-extension
Last synced: 7 months ago
JSON representation
Human discovery through code analysis - VS Code extension that reveals team expertise.
- Host: GitHub
- URL: https://github.com/andreagriffiths11/teamxray
- Owner: AndreaGriffiths11
- License: mit
- Created: 2025-06-10T12:14:15.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-06-15T15:26:32.000Z (8 months ago)
- Last Synced: 2025-06-23T18:57:46.263Z (7 months ago)
- Topics: azure-devops, chatgpt, github, github-models, mcp-server, vscode, vscode-extension
- Language: TypeScript
- Homepage:
- Size: 1.21 MB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
#Team X-Ray VS Code Extension
[](https://github.com/AndreaGriffiths11/teamxray/actions)
> *"Feeling like a stranger on my own team, surrounded by brilliant minds whose talents hide in code and commits."*
Transform GitHub Copilot into team X-ray vision. Discover the humans behind the codebase, reveal hidden expertise, and understand how your teammates naturally collaborate.
**🎥 Introduced at RenderATL 2025**: [View Presentation Slides](https://andreagriffiths11.github.io/renderatl/)
## Features
- **🔍 File Expert Discovery** - Right-click any file to find who knows it best
- **🧠 Team Expertise Overview** - AI-powered analysis of communication styles and collaboration patterns
- **🎯 Smart Challenge Matching** - Discover who thrives on different types of problems
- **⚡ MCP Integration** - Uses GitHub's Model Context Protocol for deep repository analysis
- **🎨 Pretty UI** - Modern webview interface with team insights and expert profiles
## Installation & Setup
**Development Version** - Install from source:
```bash
git clone https://github.com/AndreaGriffiths11/team-xray.git
cd team-xray
npm install
npm run compile
npm install -g @vscode/vsce && vsce package
```
**Install the .vsix file in VS Code:**
- **Command Line:** `code --install-extension teamxray-0.0.1.vsix`
- **VS Code UI:** Extensions → "..." → "Install from VSIX..." → Select the .vsix file
- **Drag & Drop:** Drag the .vsix file into VS Code
**Setup GitHub Token:**
```bash
export GITHUB_TOKEN="your_github_token_here"
```
**Usage:**
- Right-click files → "Find Subject Matter Expert"
- Command Palette → "Team X-Ray: Analyze Team Expertise"
## How It Works
- **🔄 Real Git Analysis** - Analyzes commit history and contributor patterns
- **🤖 AI Analysis** - Uses GitHub Models API (GPT-4o) for human-centered insights
- **🔌 MCP Integration** - Leverages VS Code's Model Context Protocol with GitHub's official server
- **⚡ Smart Fallback** - Works offline with local Git when MCP unavailable
## Development
**Prerequisites:** Node.js 20+, VS Code 1.100.0+, Git repository
```bash
git clone https://github.com/AndreaGriffiths11/team-xray.git
cd team-xray
npm install
export GITHUB_TOKEN="your_token"
npm run compile
# Press F5 in VS Code to test
```
## Requirements
- VS Code 1.100.0+
- Node.js 20+
- GitHub repository with commit history
- GitHub token for enhanced features
## Coming Soon...
- VS Code Marketplace publication
- Real-time MCP status monitoring
- Advanced team collaboration insights
- Cross-repository expertise aggregation
---
**Stop being a stranger on your own team. Discover the brilliant minds around you.** 🚀