Agent state

Conversation

A sculpted, living status field that changes contour and color as an agent thinks, works, asks for input, or finishes.

React · copy into your project · light and dark themes

Try it

Variant

Size

Ready when you areA little space for your next idea.

Interactive demo · Select a state to explore its movement.

Loading preview…

Take it with you

Copy the example, API and usage notes for your editor or AI assistant.

Add to your project

Terminal

npx shadcn@latest add https://luv-jeri.github.io/cojeev-ui/r/agent-state.json

The command includes the component’s shared dependencies. Your project keeps editable source files.

Include the complete example

This example also composes button. Install its parts together:

Terminal

npx shadcn@latest add https://luv-jeri.github.io/cojeev-ui/r/button.json https://luv-jeri.github.io/cojeev-ui/r/agent-state.json

Using agent state

Use status to convey actual activity: idle, thinking, working, needs-input, complete or error.
Use sm beside a task, md in a conversation, and lg for a focused empty or waiting state.
The field pauses outside the viewport, when the document is hidden, and when motion is disabled.

API

Compose the exported parts below. The prop types are read from the React source during the registry build.

Native element or underlying primitive props are inherited where declared, including accessible labels, event handlers and refs.

AgentStateProps

Prop	Type	Required
`status`	`AgentStatus`	No
`size`	`"sm" \| "md" \| "lg"`	No
`label`	`string`	No
`description`	`string`	No

Accessibility

Visible labels accompany color and shape; provide a precise label for your workflow.
Status is announced politely. Use one live state indicator per active task to avoid duplicate announcements.
Reduced motion preserves the status contour without continuous animation.

States and appearance

idlethinkingworkingneeds-inputcompleteerroroffscreenreduced-motion

For conditional content, keep a MotionPresence boundary around keyed MotionSurface children. The shared entrance and exit states work with native primitives and respect your motion preference.

Try pointer and keyboard interaction, and switch the appearance control in the navigation to compare light and dark mode. Motion respects reduced motion preferences.