AgentWatch for VS Code

Your command center for AI agent activity - Monitor Claude Code, Codex, Gemini CLI, and more from directly within VS Code.

AgentWatch

Features

Never Miss an Action Request

Get instant notifications when agents need permission or input. Sound alerts, browser notifications, and integration with Teams, Slack, Discord, and SMS.

Real-Time Visibility

Watch agents work live as sessions start, tools execute, and tasks complete. No refresh needed - events stream in real-time via WebSocket.

Store the Thought Process

Every session is captured with conversation history, tool calls, and reasoning. Review what happened, when, and why.

Multi-CLI Support

Works with all major AI coding assistants:

Claude Code - Full hook support, captures entire dev loop
Codex - Stop events for completion signals
CodexAW - Start, stop, and prompt events for multi-agent flows
Gemini CLI - Session and tool events
Noaw - Wrapper for any long-running command

What You Can Do

Track Concurrent Sessions - See all active agents, their progress, and timing
Get Notified Your Way - Sound alerts, browser notifications, or push to Teams/Slack/Discord
Review Agent History - Browse past sessions, search events, replay the thought process
Jump to Action - One click from notification to the agent needing attention

Getting Started

1. Create an Account

2. Configure the Extension

Open VS Code Settings (Ctrl+,) and search for "AgentWatch":

Server URL: https://api.agent-watch.com (default)
API Key: Paste your API key from the dashboard

Or use the command palette (Ctrl+Shift+P) and run "Agent Watch: Configure API Key".

3. Install the Agent Watch Client

Run the installer on any machine where you use AI coding agents:

# From the Agent Watch dashboard, go to Install Client
# Or run directly:
curl -sSL https://agent-watch.com/install | python3 -

4. Start Monitoring

Once configured, the extension connects automatically. You'll see:

Active Agents in the sidebar showing all running sessions
Recent Events with a live stream of agent activity
Status Bar indicator showing connection status

Extension Settings

This extension contributes the following settings:

Setting	Description	Default
`agentWatch.serverUrl`	Agent Watch API server URL	`https://api.agent-watch.com`
`agentWatch.apiKey`	Your API key from the dashboard	(empty)
`agentWatch.soundEnabled`	Enable sound notifications	`true`
`agentWatch.soundVolume`	Sound volume (0-100)	`50`
`agentWatch.soundEvents.agentStart`	Play sound when agent starts	`true`
`agentWatch.soundEvents.agentStop`	Play sound when agent stops	`true`
`agentWatch.soundEvents.agentError`	Play sound on errors	`true`
`agentWatch.soundEvents.newEvent`	Play sound for every event	`false`
`agentWatch.notifications.enabled`	Show VS Code notifications	`true`
`agentWatch.maxEvents`	Max events in sidebar	`50`
`agentWatch.autoRefreshInterval`	Auto-refresh interval (ms)	`30000`

Commands

Access these via Command Palette (Ctrl+Shift+P):

Agent Watch: Configure API Key - Set or update your API key
Agent Watch: Refresh Agents - Manually refresh the agent list
Agent Watch: Open Dashboard - Open the web dashboard
Agent Watch: Test Sound - Test sound notifications
Agent Watch: Clear API Key - Remove stored API key

Sound Notifications

AgentWatch plays sounds when agent events occur:

Agent Start - Chime when a new session begins
Agent Stop - Alert when an agent completes or stops
Agent Error - Warning sound on errors

Customize sounds in Settings or disable them entirely.

Requirements

VS Code 1.85.0 or higher
An Agent Watch account (sign up free)
Agent Watch client installed on machines running AI agents

Privacy & Security

API keys are stored securely in VS Code's secret storage
WebSocket connections use TLS encryption
No agent code or file contents are transmitted - only event metadata

Support

Documentation: agent-watch.com/docs
Issues: GitHub Issues
Dashboard: agent-watch.com

License

MIT License - see LICENSE for details.

Agent Watch - Know when agents need your attention. Review their thought process and decisions.