TitleIcon
Animated ASCII art logo with responsive visibility.
TitleIcon
An animated ASCII art title logo displayed on the idle/prompt screen. Drives frame advancement via Ink's useAnimation hook at ~16 FPS. On wide terminals (128+ columns), the full "CommaAgents" ASCII text banner is shown alongside the icon.
import { TitleIcon } from "@comma-agents/tui";
<TitleIcon />
<TitleIcon playing={false} />TitleIconProps
| Prop | Type | Default | Description |
|---|---|---|---|
playing | boolean | true | Whether the animation is playing |
Animation
Frames are pre-generated by an offline generator script (icon-generator/generator.ts) and stored in frames.json. The generator converts a 3D STL model into ASCII art frames using a luminance ramp.
At runtime, useAnimation ticks at the target FPS. A FRAME_STEP value controls how many source frames to skip per tick, keeping the animation smooth regardless of the source frame rate.
Responsive Text Banner
The full "CommaAgents" block-character text banner is wrapped in <Hide below={128}>, so it only appears when the terminal is at least 128 columns wide. On narrower terminals, only the animated icon is displayed.