Model Picker Row

Installation

pnpm dlx shadcn@latest add @cleverui/model-picker-row

Requires the @cleverui registry in your components.json, a one-off, two-line setup.

Usage

tsx

import { ModelPickerRow } from '@/components/ui/model-picker-row'

Exampletsx

'use client'

import { useState } from 'react'
import { ModelPickerRow } from '@/components/ui/model-picker-row'

const MODELS = [
  {
    id: 'haiku',
    name: 'Haiku',
    context: '200k',
    speed: 'fast',
    cost: '$0.25/M',
  },
  {
    id: 'sonnet',
    name: 'Sonnet',
    context: '200k',
    speed: 'balanced',
    cost: '$3/M',
  },
  {
    id: 'opus',
    name: 'Opus',
    context: '200k',
    speed: 'deep',
    cost: '$15/M',
  },
]

export default function ModelPickerRowDemo() {
  const [value, setValue] = useState('sonnet')

  return (
    <div className="mx-auto flex min-h-[360px] w-full max-w-2xl flex-col justify-center px-4 py-16 sm:px-6">
      <div className="rounded-2xl border border-border/60 bg-card p-5 sm:p-6">
        <div className="mb-6">
          <p className="font-mono text-[11px] uppercase tracking-[0.2em] text-muted-foreground sm:text-xs">
            meridian-ops · settings
          </p>
          <p className="mt-2 text-sm leading-relaxed text-muted-foreground">
            Pick the model for the March close recon, context, speed, and cost
            stay visible so the tradeoff is never buried in a menu.
          </p>
        </div>
        <ModelPickerRow
          label="Model"
          models={MODELS}
          value={value}
          onChange={setValue}
        />
      </div>
    </div>
  )
}

API reference

ModelPickerRow accepts the following props.

Prop	Type	Default	Description
`models`*	`ModelPickerOption[]`	–	2–4 options; mono spec strings render verbatim
`value`*	`string`	–	selected model id, fully controlled
`onChange`	`(id: string) => void`	–	fires with the clicked option's id
`label`	`string`	`'Model'`	mono micro-label naming the group

…plus everything from Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'>: className, event handlers, aria attributes and the rest pass straight through.

Referenced types

Typestsx

export interface ModelPickerOption {
  id: string
  name: string
  context?: string
  speed?: string
  cost?: string
}

Related components

Agent Status Strip

A slim strip for app headers, agent name, state lamp, a one-line current step that shimmers while running, and an SSR-safe elapsed mono timer that starts post-mount.

AI Empty State

Agent session zero state for React AI apps, starter prompt cards, connected-tool chips, and an honest scope note, styled with Tailwind hairline restraint; composes above any composer.

Citation Rail

Inline numbered source chips paired with a rail of sources, favicon placeholder, domain, and title, plus a keyboard-accessible snippet peek on hover or focus.

Context Meter

Context-window usage meter, a hairline bar with a tabular tokens-used/limit readout and per-source breakdown rows, shifting to an honest warning treatment at 85 percent.

Diff Approval Block

An agent's proposed change as reviewable hunks, mono before/after lines with token-honest added and removed tints, per-hunk approve/reject callbacks, and j/k keyboard navigation.

Generative Skeleton

A streaming placeholder that morphs, shimmering blocks resize and settle into real headings, rows, and cards as each section's content lands, so the answer arrives without a layout jump.

Frequently asked questions

How do I install the Model Picker Row component?

Register the @cleverui registry in your components.json ("@cleverui": "https://cleverops.com.au/r/{name}.json"), then run `npx shadcn@latest add @cleverui/model-picker-row`. The shadcn CLI copies the source into your project, you own the code from that point. You can also copy the source directly from this page.

What dependencies does Model Picker Row require?

Model Picker Row uses motion on top of React and Tailwind CSS. You don't need to install it manually, the shadcn CLI resolves and installs npm dependencies automatically when you add the component.

Can I theme Model Picker Row to match my brand?

Yes. The component is styled entirely with Tailwind utilities over standard design tokens (primary, background, muted, border), so it inherits your existing shadcn/ui theme automatically. Change your CSS variables and the component follows, no source edits needed for palette, radius, or fonts.

Preview & code