# AgentEmblem

> Animated AI status indicators for React: thinking, loading, streaming responses, tool use, listening, and talking. Use the built-in circle, square, spark, or cursor without artwork; custom SVG/PNG marks are also supported.

Package: agent-emblem 0.2.0. MIT. React and React DOM 18+. Browser canvas with TypeScript declarations. Install with npm install agent-emblem. AI SDK is optional; manual state works with any backend. Enable animateVisibility and animateMotion explicitly for animated marks. This is a visual component, not an agent runtime or audio processor.

## Implementation reference

- [Developer portal](https://agent-emblem.vercel.app/developers/): Quick start, documentation, public catalog endpoints, and a configuration sandbox. No account or API key needed.
- [Agent implementation guide](https://agent-emblem.vercel.app/docs/agent-guide.md): Task fit, built-in and custom marks, complete React recipes, public exports, defaults, activity mapping, and troubleshooting.
- [Full reference](https://agent-emblem.vercel.app/llms-full.txt): README and implementation guide in one Markdown response, including complete prop tables.

## Guides and examples

- [React guide](https://agent-emblem.vercel.app/docs/react/): Start without artwork, add an animated thinking indicator, and customize it.
- [Vercel AI SDK guide](https://agent-emblem.vercel.app/docs/vercel-ai-sdk/): Map an existing chat's status and assistant message parts to visible activity.
- [AI status-row pattern](https://agent-emblem.vercel.app/examples/ai-agent-status/): Pair a built-in or custom mark with accurate thinking, writing, and tool-use copy.
- [Custom SVG and PNG marks](https://agent-emblem.vercel.app/examples/animated-svg-logo/): Prepare optional logo artwork and preserve compact-size fidelity.

## Package

- [OpenAPI specification](https://agent-emblem.vercel.app/openapi.json): The real read-only HTTP catalog and documentation endpoints.
- [Package catalog](https://agent-emblem.vercel.app/api/manifest.json): Package identity, supported states, default marks, and installation metadata.
- [Built-in SVG marks](https://agent-emblem.vercel.app/api/presets.json): The four included presets as SVG strings.
- [npm](https://www.npmjs.com/package/agent-emblem): Published versions and installation.
- [GitHub](https://github.com/pologarcia/agent-emblem): Source, exported types, issues, and README.