nextui.dev
Home
Docs
Saved
Pricing
Components37
  • Forms & inputs7
  • Cards13
  • Buttons, badges & avatars8
  • Feedback & display6
  • Effects3
Agents17
  • Chat inputNew
  • Task checklistNew
  • ReasoningNew
  • Tool callNew
  • Tool approvalNew
  • SourcesNew
  • Agent timelineNew
  • Artifact panelNew
  • Streaming messageNew
  • Conversation shellNew
  • Voice agentNew
  • Voice orbNew
  • Thinking ring
  • Thinking waveNew
  • Thinking sparkle
  • Thinking bot
  • Prompt deckNew
Blocks20
  • Agent chatNew
  • Pill heroNew
  • Grid hero
  • Moodboard generatorNew
  • Waitlist heroNew
  • Intro bannerNew
  • Creative home heroNew
  • Chat heroNew
  • App shelfNew
  • Usage card
  • Design resultsNew
  • Pricing tiers
  • Dashboard home
  • The shiftNew
  • Launch perksNew
  • Testimonials
  • Quote
  • Team
  • Leads tableNew
  • Sign in
Pages13
  • ASCII workspace$49
  • Research agent$49
  • Support agent$49
  • Coding agent$49
  • CRM overviewNew
  • Marketing dashboardNew
  • Developer portfolio$49
  • Particle landing$49
  • Particle story$49
  • Statement converter$49
  • AI photo studio$49
  • Group card launch$49
  • Month-end storyNew
Themes9
  • Default
  • Ember
  • Ocean
  • Forest
  • Grape
  • Rose
  • Amber
  • Clay
  • Brutal
Upgrade
nextui.dev

nextui components, blocks and themes you install with one command.

Product

  • Components
  • Blocks
  • Themes
  • Pricing

Resources

  • Docs
  • Roadmap
  • GitHub

Legal

  • License
  • Privacy
  • Terms
  • Refunds

nextUI

[ 200 OK ] · nextUI

© 2026 NEXTUI • All rights reserved.

Upgrade
PagesResearch agent

Research agentNew

Full agent app built from the 8 agent primitives: the agent thinks, searches and reads your workspace on a live activity timeline, writes a memo into a side panel, answers with citations, then asks before it shares the memo. Scripted end to end, so it runs with no backend until you plug in your model.

Buy template · $49

Installation

Set your access key from API keys as NEXTUI_TOKEN in .env.local and add the @nextui namespace below to components.json once. Then every item installs by name. Each install counts as a copy on a free account.

$pnpm dlx shadcn@latest add @nextui/research-agent
1{
2 "registries": {
3 "@nextui": {
4 "url": "https://nextui.dev/r/{name}.json",
5 "headers": { "Authorization": "Bearer ${NEXTUI_TOKEN}" }
6 }
7 }
8}

Usage

1"use client";
2
3import { ResearchAgent } from "@/components/pages/research-agent";
4
5export default function Page() {
6 return (
7 <ResearchAgent
8 brand="Scout"
9 question="Should we move the API to usage-based pricing?"
10 onShare={(memo) => console.log("share", memo)}
11 />
12 );
13}

API reference

PropTypeDefaultDescription
brandstring"Scout"Product name in the top bar
questionstringa pricing questionAsked on load so the page opens with the agent at work; pass an empty string to start on the suggestions
suggestionsstring[]3 promptsShown in the empty chat
scriptResearchScripta pricing memoReasoning, steps, memo, answer, sources and share step the scripted run plays
onShare(memo: string) => void–The person approved the share step
classNamestring–Extra classes on the section

What it is made of

  • ConversationShell for the app frame, Reasoning, AgentTimeline, StreamingMessage, Sources and ToolApproval in each answer, and ArtifactPanel for the memo
  • The 8 primitives are free and MIT licensed; they are installed with the template
  • The side panel shows from 900px wide; the top bar's Ask AI button hides and shows it

Plugging in a real agent

  • useResearchRun plays the script against a clock; replace it with useChat from @ai-sdk/react
  • Map reasoning parts to Reasoning, your search and read tool calls to AgentTimeline events, text to StreamingMessage and then Sources once it is done
  • Give the share tool needsApproval (toolApproval in AI SDK 7) and render approval-requested parts with ToolApproval
  • The free agent starter in the nextui repo wires all of this up: npx degit tini-coder/nextui/starters/agent my-agent

Related

All pages
$49

ASCII workspaceNew

$49

Support agentNew

Sign in to see the code

Preview it freely. A free account copies code and prompts a few times a day.

$49 template
Sign in