VS Code Extension

Installation#

From Marketplace#

Search for "Aexy" in VS Code Extensions marketplace.

From VSIX#

code --install-extension aexy-vscode-0.1.0.vsix

From Source#

cd aexy-vscode
npm install
npm run compile
# Press F5 in VS Code to launch Extension Development Host

Configuration#

Open VS Code Settings (Cmd/Ctrl + ,) and search for "Aexy":

Setting API Token#

1. Get your token from Aexy web dashboard (Settings > API)
2. Open VS Code Settings
3. Search for "Aexy API Token"
4. Enter your token

Or in settings.json:

{
  "aexy.apiUrl": "https://api.aexy.io/api",
  "aexy.apiToken": "your-api-token"
}

Features#

Sidebar Views#

The Aexy icon in the Activity Bar opens three views:

1. Developer Profile View#

• Shows current developer's profile
• Displays name, GitHub username, seniority
• Lists top skills

2. Insights View#

• Team health score and grade
• Attrition risk alerts
• Burnout indicators

3. Team Overview#

• List of team members
• Top skills across team
• Skill coverage percentages

Commands#

Open Command Palette (Cmd/Ctrl + Shift + P) and type "Aexy":

Show Developer Profile#

1. Run Aexy: Show Developer Profile command
2. Enter GitHub username
3. Profile appears in sidebar

Match Task to Developer#

1. Run Aexy: Match Task to Developer command
2. Enter task description (e.g., "Fix OAuth bug in login flow")
3. Optionally enter required skills (comma-separated)
4. Select from matched developers
5. View detailed match report in new panel

Keyboard Shortcuts#

Add custom shortcuts in keybindings.json:

[
  {
    "key": "ctrl+shift+g p",
    "command": "aexy.showProfile"
  },
  {
    "key": "ctrl+shift+g m",
    "command": "aexy.matchTask"
  },
  {
    "key": "ctrl+shift+g r",
    "command": "aexy.refresh"
  }
]

Status Bar#

When connected, you'll see:

• Connection status indicator
• Quick access to commands

Troubleshooting#

Extension Not Loading#

1. Check Output panel (View > Output > Aexy)
2. Verify API URL is correct
3. Check API token is set

No Data Showing#

1. Ensure API server is running
2. Check network connectivity
3. Verify authentication token

Refresh Not Working#

1. Check aexy.autoRefresh setting
2. Manually trigger with Aexy: Refresh Data
3. Check API rate limits

Performance Issues#

1. Increase aexy.refreshInterval
2. Disable aexy.autoRefresh if not needed
3. Check API server performance

Development#

Building#

cd aexy-vscode
npm install
npm run compile

Running Tests#

npm test

Packaging#

npm run package
# Creates aexy-vscode-x.x.x.vsix

Publishing#

vsce publish

API Integration#

The extension uses the same REST API as other clients:

• /developers - Profile data
• /analytics - Team analytics
• /predictions - Insights data
• /hiring/match - Task matching

See API Overview for details.