@aws/agent-inspector

AgentCore agent inspector

A visual inspector for debugging and monitoring agents

Overview

AgentCore agent inspector is a web-based UI for interacting with and inspecting AI agents during local development with the AgentCore CLI. It provides a chat interface, real-time trace visualization, tool call inspection, token usage tracking, and resource exploration, giving you full visibility into what your agent is doing and why.

Note: This package (@aws/agent-inspector) contains prebuilt static assets for the Agent Inspector web UI. It is intended to be served by the AgentCore CLI and is not designed to be used as a standalone application.

Features

• Chat interface — Send messages to your agent and view streaming responses
• Trace timeline — Visualize the full invocation timeline, including LLM calls and tool use
• Tool inspection — Browse MCP tools and view tool call inputs/outputs
• Token usage tracking — Monitor token consumption across invocations
• Resource panel — Inspect agent resources (memory, credentials, etc.)
• Agent selection — Switch between multiple agents in your project

Getting Started

Agent Inspector is bundled with the AgentCore CLI. When you run agentcore dev, the inspector UI is served automatically — no separate installation required.

Standalone Development

To develop the inspector UI itself:

# Install dependencies
npm install

# Start dev server
npm run dev

# Build for production
npm run build

# Run tests
npm test

# Lint and format
npm run lint
npm run format

Security

See CONTRIBUTING for more information.

License

This project is licensed under the Apache-2.0 License.