This project provides a registry of accessible React components designed to replicate the terminal user interfaces of popular coding agents like Claude, Codex, and Grok. It targets developers seeking to integrate authentic-looking agent UIs into documentation, demos, marketing pages, or product interfaces without resorting to screenshots or iframes, offering a high-fidelity, drop-in solution.

How It Works

The core approach leverages shadcn/ui components, meticulously crafted for fidelity against actual terminal captures. A dedicated capture harness (tools/capture/) drives agents within tmux sessions, generating reference frames stored in references/captures/. These components are then published as a shadcn/ui registry, allowing for easy integration via the shadcn/ui CLI. This method ensures accurate visual representation and simplifies adoption.

Quick Start & Requirements

Installation involves adding the project's registry to your shadcn/ui configuration using bunx shadcn@latest registry add @brainless=https://brainless.swerdlow.dev/r/{name}.json, followed by adding specific components like @brainless/claude-session. Alternatively, the registry can be added manually to components.json. The primary requirement is bun for executing the shadcn CLI commands. Development requires bun install and bun run registry:build to build the registry JSON files.

• Primary install: bunx shadcn@latest add @brainless/<component-name>
• Prerequisites: bun
• Relevant Links:
  • Site: https://brainless.swerdlow.dev
  • Repo: https://github.com/theswerd/brainless

Highlighted Details

• Offers a comprehensive set of components for Claude, Codex, and Grok, including headers, messages, thinking indicators, tool calls, diff views, permissions, prompts, and slash menus.
• Provides pre-packaged "Blocks" like claude-session, codex-session, and grok-session for quicker integration.
• Employs a capture harness and reference captures to ensure high fidelity to real-world terminal outputs.
• Components are distributed via a shadcn/ui registry for streamlined management and installation.

Maintenance & Community

The provided README does not contain specific details regarding notable contributors, sponsorships, partnerships, or community channels such as Discord or Slack.

Licensing & Compatibility

The project is released under the MIT license. This permissive license allows for commercial use, modification, and distribution, including integration into closed-source applications without significant restrictions.

Limitations & Caveats

This repository exclusively provides UI components for replicating the visual appearance of coding agent terminals; it does not include any agent logic or functionality. Setup requires familiarity with bun and the shadcn/ui ecosystem. The fidelity is based on captured terminal states, which may not encompass all possible agent interactions or future UI evolutions.