A collection of beautifully designed, accessible, and customizable terminal UI components. Built on Ink. Works with shadcn/ui.

How do I publish components with termcn?

Add or edit components under registry/bases/ink/ or registry/bases/opentui/, register them in registry.json, run pnpm registry:build (which refreshes public/r/), then deploy. Consumers install with npx shadcn@latest add against your published registry URL.

Is termcn open source?

Yes. The source is on GitHub and released under the MIT License.

Conversation History

Arrow-key scrollable stack for long chat threads

Terminal

Installation


$ pnpm dlx shadcn@latest add @termcn/conversation-history

Usage

import { ConversationHistory } from "@/components/ui/conversation-history";
import { Text } from "ink";

<ConversationHistory maxHeight={12} isActive>
  <Text>user: Hello</Text>
  <Text>assistant: Hi — how can I help?</Text>
</ConversationHistory>

When isActive is true, ↑ / ↓ move the window over children. The view starts scrolled to the bottom (maxHeight lines visible).

API Reference

ConversationHistory

Prop	Type	Default
`maxHeight`	`number`	`20`
`children`	`ReactNode`	-
`showScrollHint`	`boolean`	`true`
`isActive`	`boolean`	`true`

Chat Thread Error Retry

On This Page

Installation Usage API Reference ConversationHistory

Edit this page Follow @shadcnlabs Join community