# terminal-kit

> terminal-kit is a shadcn registry of React components for terminal-style agent UIs — Claude Code, Grok, and similar. Install with the shadcn CLI; components ship theme CSS, built-in palettes, and layout modes.

Built on shadcn/ui, React 19, Next.js, and Tailwind CSS. Eight components cover window chrome, transcript streaming, input, tool output, and agent prompts.

## Documentation

- [README](https://github.com/Malayvasa/terminal-kit/blob/main/README.md): Overview, install slugs, and links
- [Installation](https://www.terminal-kit.com/docs/installation): Prerequisites and shadcn CLI commands
- [Theming](https://www.terminal-kit.com/docs/theming): CSS tokens, built-in palettes, SessionContent integration
- [llms.txt](https://www.terminal-kit.com/llms.txt): LLM index
- [llms-full.txt](https://www.terminal-kit.com/llms-full.txt): Full docs for AI tools
- [Scripted demo chat](https://www.terminal-kit.com/llms-full.txt#scripted-demo-chat): Fake agent session with questions and streaming phases

## Components

- [components/terminal-kit/shell/terminal-window.tsx](https://github.com/Malayvasa/terminal-kit/blob/main/components/terminal-kit/shell/terminal-window.tsx): Window chrome, line primitives, scroll body, and theme tokens. Base for every terminal-kit component.
- [components/terminal-kit/session/message.tsx](https://github.com/Malayvasa/terminal-kit/blob/main/components/terminal-kit/session/message.tsx): Submitted user message row, shown inside SessionContent.
- [components/terminal-kit/session/session-content.tsx](https://github.com/Malayvasa/terminal-kit/blob/main/components/terminal-kit/session/session-content.tsx): Transcript container with optional streaming reveal and auto-scroll.
- [components/terminal-kit/input/input.tsx](https://github.com/Malayvasa/terminal-kit/blob/main/components/terminal-kit/input/input.tsx): Bottom prompt input with blinking cursor and status metadata.
- [components/terminal-kit/agent/question-prompt.tsx](https://github.com/Malayvasa/terminal-kit/blob/main/components/terminal-kit/agent/question-prompt.tsx): Multiple-choice Q&A prompt for ambiguous tasks.
- [components/terminal-kit/agent/edit-block.tsx](https://github.com/Malayvasa/terminal-kit/blob/main/components/terminal-kit/agent/edit-block.tsx): File edit block with line numbers and diff highlights.
- [components/terminal-kit/ui/thinking-indicator.tsx](https://github.com/Malayvasa/terminal-kit/blob/main/components/terminal-kit/ui/thinking-indicator.tsx): Animated dot-matrix thinking state while the agent works.
- [components/terminal-kit/ui/stream-text.tsx](https://github.com/Malayvasa/terminal-kit/blob/main/components/terminal-kit/ui/stream-text.tsx): Agent text that types out or fades in word-by-word, plus the useTextStream hook.

## Registry

- [full-bundle](https://www.terminal-kit.com/r/full-bundle.json): Install all eight components
- [registry index](https://www.terminal-kit.com/r/registry.json): shadcn registry metadata

## Optional

- [AGENTS.md](https://github.com/Malayvasa/terminal-kit/blob/main/AGENTS.md): Maintainer notes for agents working in this repo
- [shadcn/ui docs](https://ui.shadcn.com/docs): Required setup before installing terminal-kit
- [llms.txt spec](https://llmstxt.org/): Format used by this file