brainless

NameLast commit messageLast commit date
appAdd xulux used-by strip and hide theme toggle on mobile.3 months ago
componentsAdd xulux used-by strip and hide theme toggle on mobile.3 months ago
docsAlign brainless with the shadcn registry getting-started guide.3 months ago
libAlign brainless with the shadcn registry getting-started guide.3 months ago
publicAdd xulux used-by strip and hide theme toggle on mobile.3 months ago
referencesPublish brainless: Claude, Codex, and Grok as shadcn components.3 months ago
registryfix3 months ago
toolsPublish brainless: Claude, Codex, and Grok as shadcn components.3 months ago
.gitignorePublish brainless: Claude, Codex, and Grok as shadcn components.3 months ago
AGENTS.mdInitial commit from Create Next App4 months ago
bun.lockPublish brainless: Claude, Codex, and Grok as shadcn components.3 months ago
CLAUDE.mdInitial commit from Create Next App4 months ago
components.jsonPublish brainless: Claude, Codex, and Grok as shadcn components.3 months ago
eslint.config.mjsInitial commit from Create Next App4 months ago
LICENSEPublish brainless: Claude, Codex, and Grok as shadcn components.3 months ago
next.config.tsAlign brainless with the shadcn registry getting-started guide.3 months ago
package.jsonAlign brainless with the shadcn registry getting-started guide.3 months ago
postcss.config.mjsInitial commit from Create Next App4 months ago
README.mdAlign brainless with the shadcn registry getting-started guide.3 months ago
registry.jsonAlign brainless with the shadcn registry getting-started guide.3 months ago
tsconfig.jsonInitial commit from Create Next App4 months ago
README.md

brainless

Claude Code, Codex, and Grok interfaces as shadcn components.

Site: brainless.swerdlow.dev · Repo: github.com/theswerd/brainless

brainless homepage — Claude Code session

Codex session Grok session

What is this?

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.

Install

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:

{
  "registries": {
    "@brainless": "https://brainless.swerdlow.dev/r/{name}.json"
  }
}

URL

bunx shadcn@latest add https://brainless.swerdlow.dev
bunx shadcn@latest add https://brainless.swerdlow.dev/r/claude-session.json

GitHub

bunx shadcn@latest add theswerd/brainless/claude-session

Browse individual pieces on components and blocks.

Components

Family Pieces
Claude header, message, thinking, tool call, diff, permission, prompt, slash menu, todo list
Codex header, message, working, exec, diff, permissions, prompt, slash menu
Grok status, header, message, thinking, thought, tool, write, turn end, prompt, slash menu, and more
Blocks claude-session, codex-session, grok-session, grok-session-active

Components catalog Blocks catalog

Repo layout

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

Fidelity starts from real terminal output. The capture tools under tools/capture/ drive agents in tmux, dump frames as ANSI / HTML / text, and land them in references/captures/ for side-by-side review.

Develop

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