brainless provides shadcn-ui components that emulate Claude Code, Codex, and Grok terminal UIs for integration into docs and demos. It offers registry-based components and a local development flow.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
brainless is a shadcn/ui registry of accessible React components that recreate the terminal UIs of coding agents — Claude Code, OpenAI Codex, and Grok — so you can drop them into docs, demos, marketing pages, and product UI without screenshots or iframes. Components are built for fidelity against real terminal captures, then shipped as copy-pasteable registry items.
How it works
The repository organizes source components under registry/brainless/, with a built registry JSON under public/r/. It uses a capture harness under tools/capture/ that dumps frames (ANSI / HTML / text) from tmux captures into references/captures/ for review. The docs site runs with Next.js, and the build process generates registry JSON files.
Getting started
Install methods are provided via the README:
"bash" "bunx shadcn@latest registry add @brainless=https://brainless.swerdlow.dev/r/{name}.json" "bunx shadcn@latest add @brainless/claude-session" "bunx shadcn@latest add @brainless/codex-session" "bunx shadcn@latest add @brainless/grok-session" "
Or add the registry manually in components.json:
"json" "{" " \"registries\": {" " \"@brainless\": \"https://brainless.swerdlow.dev/r/{name}.json\"" " }" "}" "
URL
"bash" "bunx shadcn@latest add https://brainless.swerdlow.dev" "bunx shadcn@latest add https://brainless.swerdlow.dev/r/claude-session.json" "
GitHub
"bash" "bunx shadcn@latest add theswerd/brainless/claude-session" "
Browse individual pieces on components and blocks pages as linked in the README.
Components
The catalog includes families Claude, Codex, Grok with multiple pieces such as header, message, thinking, tool call, diff, permission, prompt, slash menu, todo list for Claude; header, message, working, exec, diff, permissions, prompt, slash menu for Codex; status, header, message, thinking, thought, tool, write, turn end, prompt, slash menu for Grok, plus blocks like grok-session variants.
Repo layout
Key directories:
- registry/brainless/ — source components (claude / codex / grok / blocks / ui)
- public/r/ — built registry JSON for shadcn add
- references/captures/ — ANSI / HTML / text frames from real CLIs
- tools/capture/ — tmux capture harness
- app/ — docs site (Next.js)
- docs/screenshots/ — README screenshots
Capture harness
Capture tools under tools/capture/ drive agents in tmux, dump frames as ANSI / HTML / text, land them in references/captures/ for side-by-side review.
Develop
"bash" "bun install" "bun run registry:build # writes public/r/*.json" "bun run dev" "
bun run build runs the registry build, then Next.js.
License
MIT