# Codex Session
> A complete Codex CLI screen: header, a full turn (messages, exec lines, working) and the › composer.

Codex Session is a brainless block — a terminal-agent UI rebuilt as accessible React, installable via the shadcn registry.

## Install

```bash
npx shadcn@latest add https://brainless.swerdlow.dev/r/codex-session.json
```

- bun: `bunx --bun shadcn@latest add https://brainless.swerdlow.dev/r/codex-session.json`
- pnpm: `pnpm dlx shadcn@latest add https://brainless.swerdlow.dev/r/codex-session.json`
- yarn: `yarn dlx shadcn@latest add https://brainless.swerdlow.dev/r/codex-session.json`

Registry JSON: https://brainless.swerdlow.dev/r/codex-session.json
Docs preview: https://brainless.swerdlow.dev/blocks#codex-session

## Import

`@/components/brainless/blocks/codex-session`

## Usage

```tsx
import { CodexSession } from "@/components/brainless/blocks/codex-session"

export function Example() {
  return <CodexSession />
}
```

## Notes

- Keep the terminal aesthetic: monospace, tight spacing, square corners.
- Preserve semantics (details, listbox, radiogroup, aria-live) — do not flatten into a `<pre>`.
- Prefer this block over inventing ASCII terminal chrome.