AEG for VS Code 0.1.0 alpha

Find the right agent skill without leaving your editor.

Discover local skills, get a recommendation for the task in front of you, record lightweight usage metrics, and share feedback—all inside VS Code.

Early access: the extension is not yet listed in the VS Code Marketplace. The instructions below build a local VSIX from the open-source repository and install it in about five minutes.

Before you begin

Three things you need

VS Code 1.90+Desktop version with access to Extensions.
Node.js + npmNode.js 20 LTS or a newer supported release.
GitUsed to clone the AEG repository locally.

Install

Build once. Install from VSIX.

These commands download the source, compile the TypeScript extension, and create agent-experience-graph-0.1.0.vsix.

Clone the repository

Run this in Terminal, PowerShell, or the integrated terminal in VS Code.

git clone https://github.com/yao23/agent-experience-graph.git
cd agent-experience-graph/integrations/vscode

Compile and package the extension

npx runs the official VS Code extension packager without requiring a global install.

npm install
npm run compile
npx @vscode/vsce package

Install the generated VSIX

In VS Code

Open Extensions → select the menu → Install from VSIX… → choose agent-experience-graph-0.1.0.vsix.

From the command line

Run the command below from integrations/vscode.

code --install-extension agent-experience-graph-0.1.0.vsix

First run

Try the product loop

Open a workspace that contains at least one SKILL.md or capability.json, then open the Command Palette with ⇧⌘P on macOS or Ctrl+Shift+P on Windows/Linux.

  1. AEG: Discover Workspace Skills — scan the current workspace for local agent skills.
  2. AEG: Recommend Skill for Current Task — select code or text, right-click, and ask AEG for a relevant skill.
  3. AEG: Rate a Skill — add a 1–5 rating after you try a recommendation.
  4. AEG: Show Skill Metrics — inspect local use count, estimated context tokens, and average rating.

What is included

A small alpha with a focused job

Discover

Find SKILL.md and capability.json files across your workspace.

Recommend

Match the current task or selected editor text to a relevant local skill.

Rate

Capture lightweight developer feedback after using a skill.

Measure locally

Review usage and estimated token metrics before hosted telemetry exists.

Privacy by default

Your alpha metrics stay in your workspace.

AEG stores local metrics in .aeg/skill-metrics.json. Version 0.1.0 does not send telemetry to a hosted service. Token counts are estimates based on text length, not model-provider billing records.

Troubleshooting

Quick fixes

AEG found no skills

Make sure the folder currently open in VS Code contains a SKILL.md or capability.json. You can change the default patterns in the aeg.skillGlobs setting.

The VSIX was not created

Confirm you are inside agent-experience-graph/integrations/vscode. Run npm install and npm run compile again, then rerun npx @vscode/vsce package.

The code command is unavailable

Use the VS Code interface instead: Extensions → … → Install from VSIX…. On macOS, you can also install the shell command from the Command Palette with “Shell Command: Install 'code' command in PATH”.

Help shape AEG

Try one real task, then tell us what made the recommendation useful—or wrong.

The alpha is designed to learn from concrete developer workflows before the Marketplace release.