Agent Lens

Understand what your AI coding agents are actually doing.

Agent Lens gives you visibility into your GitHub Copilot, Claude Code, and OpenAI Codex CLI sessions — which agents ran, what models they used, how many tokens they consumed, and how your agent workflows connect.

Why Agent Lens?

AI coding agents are powerful but opaque. When you use custom agents in GitHub Copilot or sub-agents in Claude Code, it's hard to know:

• Which agents are doing the most work?
• How are tokens distributed across models?
• Are your custom agents and skills actually being used?
• How do your agents hand off work to each other?

Agent Lens answers these questions by parsing your local session data and presenting it visually — right inside VS Code.

Features

Metrics Dashboard

See token usage, model distribution, agent activity, tool calls, and skill usage at a glance. Filter by provider (Copilot, Claude, Codex, or all). Spot unused agents and skills that might need attention.

Agent & Skill Explorer

Browse your agents and skills in the sidebar. See their tools, models, and handoff chains. Click to open the source file.

Agent Graph

Interactive DAG visualization of your agents, skills, and handoff connections. Zoom, pan, and hover for details.

Session Explorer

Replay individual sessions as a timeline. See each request's agent, model, tokens, tool calls, and timing. Spot agent switches and model changes.

Cache Token Metrics

For Claude Code sessions: see cache read tokens, cache creation tokens, cache hit ratio, and an input token breakdown showing cached vs non-cached input.

Supported AI Tools

Session data stays local — Agent Lens only reads files already on your machine.

Getting Started

1. Install Agent Lens from the VS Code Marketplace
2. Open a project where you've used GitHub Copilot or Claude Code
3. Look for the Agent Lens icon in the activity bar
4. Click Show Metrics Dashboard or Session Explorer to explore your sessions

Agent Lens automatically discovers sessions for your current workspace. No configuration needed in most cases.

Devcontainers & Remote SSH

If your sessions live on a mounted host path, configure the directory manually:

Use the Agent Lens: Container Setup Guide command for step-by-step instructions.

Contributing

Found a bug or have an idea? Open an issue or submit a pull request.

License

MIT