whatisgithub

What is brainless?

theswerd/brainless — explained in plain English

Analysis updated 2026-05-18

405TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A shadcn/ui component library that recreates the terminal interfaces of Claude Code, Codex, and Grok as copy-pasteable React components for docs and demos.

Mindmap

mindmap
  root((brainless))
    What it does
      Recreates agent terminal UIs
      Ships as shadcn components
      Captures real CLI output
    Tech stack
      TypeScript
      React
      shadcn/ui
      Next.js
    Use cases
      Docs and demos
      Marketing pages
      Product UI mockups
    Audience
      Developers
      Docs writers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Embed a realistic Claude Code, Codex, or Grok terminal UI in documentation without screenshots.

USE CASE 2

Drop a full prebuilt coding-agent session block into a marketing or product demo page.

USE CASE 3

Capture real terminal output from a coding agent to keep component fidelity accurate.

What is it built with?

TypeScriptReactshadcn/uiNext.jsBun

How does it compare?

theswerd/brainlessopenclaw/clawpatchcoreworxlab/caal
Stars405412395
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatehard
Complexity2/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Install individual components directly via the shadcn CLI, no server setup required.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Brainless is a library of ready made React components that recreate the look and feel of terminal based AI coding assistants, specifically Claude Code, OpenAI Codex, and Grok. Instead of pasting screenshots or embedding an iframe when you want to show what one of these tools looks like in action, you can drop in a real, working component that matches the actual terminal interface closely. The components are built using the shadcn UI system, which means they are copy paste style pieces you add directly into your own project rather than a typical package you just import from a registry. Each family of components covers the different pieces you would see in a real session: headers, chat messages, thinking or reasoning steps, tool calls, code diffs, permission prompts, the text input box, and slash command menus. There are also full prebuilt session blocks that combine these pieces into a complete Claude, Codex, or Grok style conversation view, including a live active state for Grok. To make sure the components actually look like the real tools, the project includes a capture system that runs these coding agents inside a terminal multiplexer called tmux, records the raw output as ANSI, HTML, and plain text frames, and stores those captures for comparison while building and refining the components. Installing brainless works through the shadcn command line tool, either by adding the whole registry under a namespace, pulling a component directly by URL, or referencing the GitHub repository path for a specific piece. The project itself is a documentation website built with Next.js, and development uses the Bun runtime and package manager. This is a useful tool for developers who write documentation, build product demos, or design marketing pages that need to accurately show what an AI coding agent's terminal interface looks like, without relying on static screenshots. It is released under the MIT License and has 405 stars.

Copy-paste prompts

Prompt 1
Show me how to install the claude-session block from brainless using the shadcn CLI.
Prompt 2
Explain how the tmux capture harness in this repo records real terminal frames for these components.
Prompt 3
Help me build a custom demo page that shows a Codex tool-call and diff component side by side.
Prompt 4
Walk me through the repo layout so I can add a new component family to brainless.

Frequently asked questions

What is brainless?

A shadcn/ui component library that recreates the terminal interfaces of Claude Code, Codex, and Grok as copy-pasteable React components for docs and demos.

What language is brainless written in?

Mainly TypeScript. The stack also includes TypeScript, React, shadcn/ui.

What license does brainless use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is brainless to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is brainless for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.