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
## Run checks before commit
npm run check
Security
See CONTRIBUTING for more information.
License
This project is licensed under the Apache-2.0 License.