Skip to content
WebJs
Menu

Displays a command the agent runs, with its output as it streams.

Run the checks, then build the app.
Ran pnpm lint
> [email protected] lint
> eslint .
Ran pnpm test
> [email protected] test
> vitest run

 ✓ lib/ai.test.ts (6 tests) 41ms
 ✓ components/chat.test.tsx (9 tests) 212ms

 Test Files  2 passed (2)
      Tests  15 passed (15)
Ran pnpm build
> [email protected] build
> next build

   ▲ Next.js 16.3.0
   Creating an optimized production build ...
 ✓ Compiled successfully in 4.2s
 ✓ Generating static pages (12/12)

Route (app)                Size  First Load JS
┌ ○ /                     1.9 kB       112 kB
└ ƒ /api/chat              141 B       102 kB

Lint and tests pass, and the build compiled both routes.

import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { bubbleClass, bubbleContentClass } from '#components/ui/bubble.ts';
import { buttonClass } from '#components/ui/button.ts';
import {
  codeBlockClass, codeBlockContentClass, codeBlockCodeClass,
} from '#components/ui/code-block.ts';
import { messageClass, messageContentClass } from '#components/ui/message.ts';
import {
  traceClass, traceLineClass, traceIconClass, traceTitleClass,
  traceCollapsibleClass, traceCollapsibleTriggerClass, traceCollapsibleContentClass,
} from '#components/ui/trace.ts';
import { ChevronRightIcon, TerminalIcon } from '#lib/ui/lucide.ts';

const question = 'Run the checks, then build the app.';
const answer = 'Lint and tests pass, and the build compiled both routes.';

const COMMANDS = [
  {
    command: 'pnpm lint',
    output: ['> [email protected] lint', '> eslint .'],
  },
  {
    command: 'pnpm test',
    output: [
      '> [email protected] test',
      '> vitest run',
      '',
      ' ✓ lib/ai.test.ts (6 tests) 41ms',
      ' ✓ components/chat.test.tsx (9 tests) 212ms',
      '',
      ' Test Files  2 passed (2)',
      '      Tests  15 passed (15)',
    ],
  },
  {
    command: 'pnpm build',
    output: [
      '> [email protected] build',
      '> next build',
      '',
      '   ▲ Next.js 16.3.0',
      '   Creating an optimized production build ...',
      ' ✓ Compiled successfully in 4.2s',
      ' ✓ Generating static pages (12/12)',
      '',
      'Route (app)                Size  First Load JS',
      '┌ ○ /                     1.9 kB       112 kB',
      '└ ƒ /api/chat              141 B       102 kB',
    ],
  },
];

// A command that exited with 0. Only the last one renders open once the
// reply has finished.
function CommandRow(entry: { command: string; output: string[] }, open: boolean) {
  return html`
    <details data-slot="trace-collapsible" ?open=${open} class=${traceCollapsibleClass()}>
      <summary data-slot="trace-collapsible-trigger" class=${traceCollapsibleTriggerClass()}>
        <span data-slot="trace-line" class=${traceLineClass()}>
          <span data-slot="trace-icon" aria-hidden="true" class=${traceIconClass()}>${TerminalIcon()}</span>
          <span data-slot="trace-title" class=${traceTitleClass()}>Ran ${entry.command}</span>
        </span>
        <span data-slot="trace-icon" aria-hidden="true" class=${cn(traceIconClass(), 'transition-transform [[open]>summary>&]:rotate-90')}>${ChevronRightIcon()}</span>
      </summary>
      <div data-slot="trace-collapsible-content" class=${traceCollapsibleContentClass()}>
        <div data-slot="code-block" data-variant="default" data-size="sm" class=${codeBlockClass()}>
          <pre data-slot="code-block-content" data-wrap tabindex="0" dir="ltr" style="counter-reset: line 0" class=${cn(codeBlockContentClass(), 'max-h-64')}><code data-slot="code-block-code" class=${codeBlockCodeClass()}>${entry.output.join('\n')}</code></pre>
        </div>
      </div>
    </details>
  `;
}

// The conversation once every command has exited.
export default function TerminalDemo() {
  return html`
    <div class="flex min-h-72 w-full max-w-sm flex-col gap-4 py-6 text-sm">
      <div data-slot="message" data-align="end" class=${messageClass()}>
        <div data-slot="message-content" class=${messageContentClass()}>
          <div data-slot="bubble" data-variant="muted" data-align="end" class=${bubbleClass({ variant: 'muted' })}>
            <div data-slot="bubble-content" class=${bubbleContentClass()}>${question}</div>
          </div>
        </div>
      </div>
      <div data-slot="message" data-align="start" class=${messageClass()}>
        <div data-slot="message-content" class=${cn(messageContentClass(), 'gap-4')}>
          <div data-slot="trace" class=${traceClass()}>
            ${COMMANDS.map((entry, index) => CommandRow(entry, index === COMMANDS.length - 1))}
          </div>
          <p>${answer}</p>
        </div>
      </div>
      <button type="button" data-slot="button" data-variant="outline" data-size="sm" class=${cn(buttonClass({ variant: 'outline', size: 'sm' }), 'mt-auto self-start')}>
        Replay
      </button>
    </div>
  `;
}
View Code

Terminal is a shell command the agent runs, such as a lint, a test run or a build. The line shows the command, and its output streams in underneath while it runs.

Terminal is built with a trace, with a trace collapsible for each command.

Installation

Terminal is built with the Trace and Code Block components.

pnpm dlx @webjsdev/ui add trace code-block

Usage

import { codeBlockClass, codeBlockCodeClass, codeBlockContentClass } from '#components/ui/code-block.ts';
import {
  traceClass,
  traceCollapsibleClass,
  traceCollapsibleContentClass,
  traceCollapsibleTriggerClass,
  traceIconClass,
  traceLineClass,
  traceTitleClass,
} from '#components/ui/trace.ts';
<div data-slot="trace" class=${traceClass()}>
  <details data-slot="trace-collapsible" class=${cn(traceCollapsibleClass(), 'group/trace-collapsible')}>
    <summary data-slot="trace-collapsible-trigger" class=${traceCollapsibleTriggerClass()}>
      <span data-slot="trace-line" class=${traceLineClass()}>
        <span data-slot="trace-icon" aria-hidden="true" class=${traceIconClass()}>
          ${TerminalIcon()}
        </span>
        <span data-slot="trace-title" class=${traceTitleClass()}>Ran pnpm build</span>
      </span>
      <span data-slot="trace-icon" aria-hidden="true" class=${cn(traceIconClass(), 'transition-transform group-open/trace-collapsible:rotate-90')}>
        ${ChevronRightIcon()}
      </span>
    </summary>
    <div data-slot="trace-collapsible-content" class=${traceCollapsibleContentClass()}>
      <div data-slot="code-block" data-variant="default" data-size="sm" class=${codeBlockClass()}>
        <pre data-slot="code-block-content" data-wrap tabindex="0" class=${cn(codeBlockContentClass(), 'max-h-64')}><code data-slot="code-block-code" class=${codeBlockCodeClass()}>${output}</code></pre>
      </div>
    </div>
  </details>
</div>

Exit Code

A command that exits with any code other than 0 failed. Set data-status="error".

Ran pnpm install
pnpm lint exited with code 1
> [email protected] lint
> eslint .

app/api/chat/route.ts
  14:7  error  'model' is assigned a value but never used  no-unused-vars

components/chat.tsx
  42:5  error  React Hook useEffect has a missing dependency: 'messages'  react-hooks/exhaustive-deps

✖ 2 problems (2 errors, 0 warnings)

 ELIFECYCLE  Command failed with exit code 1.
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import {
  codeBlockClass, codeBlockContentClass, codeBlockCodeClass,
} from '#components/ui/code-block.ts';
import {
  traceClass, traceLineClass, traceIconClass, traceTitleClass,
  traceCollapsibleClass, traceCollapsibleTriggerClass, traceCollapsibleContentClass,
} from '#components/ui/trace.ts';
import { ChevronRightIcon, TerminalIcon } from '#lib/ui/lucide.ts';

const LINT_OUTPUT = `> [email protected] lint
> eslint .

app/api/chat/route.ts
  14:7  error  'model' is assigned a value but never used  no-unused-vars

components/chat.tsx
  42:5  error  React Hook useEffect has a missing dependency: 'messages'  react-hooks/exhaustive-deps

✖ 2 problems (2 errors, 0 warnings)

 ELIFECYCLE  Command failed with exit code 1.`;

export default function TerminalError() {
  return html`
    <div data-slot="trace" class=${cn(traceClass(), 'max-w-sm')}>
      <span data-slot="trace-line" class=${traceLineClass()}>
        <span data-slot="trace-icon" aria-hidden="true" class=${traceIconClass()}>${TerminalIcon()}</span>
        <span data-slot="trace-title" class=${traceTitleClass()}>Ran pnpm install</span>
      </span>
      <details data-slot="trace-collapsible" open class=${traceCollapsibleClass()}>
        <summary data-slot="trace-collapsible-trigger" class=${traceCollapsibleTriggerClass()}>
          <span data-slot="trace-line" data-status="error" class=${traceLineClass()}>
            <span data-slot="trace-icon" aria-hidden="true" class=${traceIconClass()}>${TerminalIcon()}</span>
            <span data-slot="trace-title" class=${traceTitleClass()}>pnpm lint exited with code 1</span>
          </span>
          <span data-slot="trace-icon" aria-hidden="true" class=${cn(traceIconClass(), 'transition-transform [[open]>summary>&]:rotate-90')}>${ChevronRightIcon()}</span>
        </summary>
        <div data-slot="trace-collapsible-content" class=${traceCollapsibleContentClass()}>
          <div data-slot="code-block" data-variant="default" data-size="sm" class=${codeBlockClass()}>
            <pre data-slot="code-block-content" data-wrap tabindex="0" dir="ltr" style="counter-reset: line 0" class=${cn(codeBlockContentClass(), 'max-h-64')}><code data-slot="code-block-code" class=${codeBlockCodeClass()}>${LINT_OUTPUT}</code></pre>
          </div>
        </div>
      </details>
    </div>
  `;
}
View Code
Commanddata-statusTitle
Running"running"Running pnpm build
Exited with 0noneRan pnpm build
Exited with another code"error"pnpm lint exited with code 1

The command is a tool call, so its states map the same way as in Tool.

Open While Running

Open the line once the first output arrives, with ?open=${running && output.length > 0}, so the output is visible while the command runs. After that the open state is the <details> element's own, as in Trace.

AI SDK

A tool result arrives only once the command exits. To stream the output while it runs, write it from the tool as a data part with the tool call's id, each time with the output so far. Where your component collects the parts, keep the latest data part for each id, so the output grows in place. See AI SDK for streaming the parts from a 'use server' action.

yield {
  type: 'data-terminal',
  id: toolCallId,
  data: { output },
};

On the client, find the data part that matches each tool part.

function getOutput(message: ChatMessage, toolCallId: string) {
  for (const part of message.parts) {
    if (part.type === 'data-terminal' && part.id === toolCallId) {
      return part.data.output;
    }
  }

  return '';
}

Migrating from AI SDK Elements

If you used Terminal from AI SDK Elements, its wrapper lives in components/ai-elements/terminal.tsx. In a WebJs app it becomes this pattern, built from WebJs UI components. Each export of the wrapper maps onto a part:

AI SDK ElementsWebJs UI
TerminalA trace with a trace collapsible, opened once output arrives while the command runs.
TerminalHeaderThe collapsible's <summary>, holding a trace line with data-status="running" while the command streams.
TerminalTitleA trace icon with the terminal icon and a trace title, like "Ran pnpm build".
TerminalContentThe trace collapsible content, holding a Code Block with data-size="sm" and a data-wrap content with max-h-64 for the output.
TerminalStatus, TerminalActions, TerminalCopyButton, TerminalClearButtonMarkup next to the <summary>, not inside it, since a button cannot sit inside a trigger.

API Reference

See Trace.