Agent Loading States

Agent Loading States: Three thoughtful loading states for AI interfaces: shimmering status text, live agent progress, and cycling reasoning phrases. Free MIT React & Next.js source with Motion and Tailwind CSS, live preview, CLI install and docs.

Install Agent Loading States

npx motion-ui-skill add loading-states

Components install as source into your project. The interactive page also includes preview, code, documentation and install tabs.

Dependencies

  • clsx
  • motion
  • react
  • tailwind-merge

Source files

Agent Loading States

Three thoughtful loading states for AI interfaces: shimmering status text, live agent progress, and cycling reasoning phrases.

Install

Reasoning Text

Shimmering reasoning copy with an ASCII loader and cascade, phrase-swap, or per-letter scramble transitions.

npx motion-ui-skill add reasoning-text

Thinking Shimmer

A quiet shimmer that keeps the agent's current status readable while work continues.

npx motion-ui-skill add thinking-shimmer

Agent Progress

A compact activity glyph, action verb, and live tabular timer for longer-running agent work.

npx motion-ui-skill add agent-progress

Dependencies

  • clsx
  • motion
  • react
  • tailwind-merge

Usage

Reasoning Text usage

Shimmering reasoning copy with an ASCII loader and cascade, phrase-swap, or per-letter scramble transitions.

"use client";

import {
  ReasoningText,
  type ReasoningTextVariant,
} from "@/components/agents/loading-states/reasoning-text";

const EXAMPLES: {
  label: string;
  variant: ReasoningTextVariant;
  phrases: string[];
}[] = [
  {
    label: "Cascade",
    variant: "cascade",
    phrases: [
      "Thinking",
      "Reading the request",
      "Working through the details",
      "Preparing the answer",
    ],
  },
  {
    label: "Swap",
    variant: "swap",
    phrases: [
      "Thinking",
      "Reading the request",
      "Working through the details",
      "Preparing the answer",
    ],
  },
  {
    label: "Scramble",
    variant: "scramble",
    phrases: ["Thinking", "Searching", "Reasoning", "Composing"],
  },
];

export function ReasoningTextPreview() {
  return (
    <div className="grid w-full max-w-sm gap-7">
      {EXAMPLES.map(({ label, variant, phrases }) => (
        <div key={variant} className="grid gap-2">
          <span className="text-[11px] font-medium uppercase tracking-wider text-muted-foreground/60">
            {label}
          </span>
          <ReasoningText
            variant={variant}
            phrases={phrases}
            className="text-base"
          />
        </div>
      ))}
    </div>
  );
}

Thinking Shimmer usage

A quiet shimmer that keeps the agent's current status readable while work continues.

"use client";

import { ThinkingShimmer } from "@/components/agents/loading-states/thinking-shimmer";

export function ThinkingShimmerPreview() {
  return (
    <ThinkingShimmer className="text-lg" duration={1.8}>
      Thinking…
    </ThinkingShimmer>
  );
}

Agent Progress usage

A compact activity glyph, action verb, and live tabular timer for longer-running agent work.

"use client";

import { AgentProgress } from "@/components/agents/loading-states/agent-progress";

export function AgentProgressPreview() {
  return (
    <AgentProgress
      label="Churning"
      initialSeconds={151.6}
      className="text-base"
    />
  );
}

API Reference

ReasoningText

Prop Type Default Required Description
phrases string[] [ "Thinking", "Reading the context", "Connecting the details", "Forming a response", ] No Phrases cycled through while the agent works.
variant "scramble" | "cascade" | "swap" cascade No Animation used when the active phrase changes.
interval number 1800 No Milliseconds each phrase remains visible.
shimmerDuration number 2.2 No Seconds taken for one shimmer pass.
indicator ReactNode — No Optional leading visual. Defaults to a terminal-style ASCII loader.
className string — No —

ThinkingShimmer

Prop Type Default Required Description
children ReactNode Thinking… No Loading message shown to the user.
duration number 1.8 No Seconds taken for one shimmer pass.
className string — No —

AgentProgress

Prop Type Default Required Description
label string Churning No Verb describing the agent's current activity.
elapsedSeconds number — No Controlled elapsed time in seconds.
initialSeconds number 0 No Starting time for the internal timer, in seconds.
running boolean true No Whether the internal timer should advance. Ignored when elapsedSeconds is provided.
className string — No —

Browse this category