# Grok Status
> Top status bar — branch glyph, cwd, context usage (16K / 500K), and optional turn progress (2/3 ✓).

Grok Status is a brainless component — a terminal-agent UI rebuilt as accessible React, installable via the shadcn registry.

## Install

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

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

Registry JSON: https://brainless.swerdlow.dev/r/grok-status.json
Docs preview: https://brainless.swerdlow.dev/components#grok-status

## Import

`@/components/brainless/grok/grok-status`

## Usage

```tsx
import { GrokStatus } from "@/components/brainless/grok/grok-status"

export function Example() {
  return (
    <GrokStatus
      branch="main"
      directory="~/dev/brainless"
      turn={2}
      turnTotal={3}
    />
  )
}
```

## 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 component over inventing ASCII terminal chrome.