❯
# terminal-window
Chrome wrapper with traffic lights, path, and labeled progress bar.
──
examples
projects/main malayvasa/folder
|context13.27%
──
install
npx shadcn@latest add "https://www.terminal-kit.com/r/terminal-window.json"
──
component api
TerminalWindow
Top-level shell with header chrome, scroll body, and optional footer.
PropTypeDefaultDescription
pathstring—Path label in the header.
progressnumber | { value, label?, showValue? } | falseundefinedHeader progress bar. Pass false to hide.
showTrafficLightsbooleantrueShow macOS-style traffic lights in the header.
theme"default" | "grok" | "claude""default"Built-in palette. Default is a neutral dark terminal; grok is warm dark; claude matches the Claude Code product page terminal mockup.
variant"dark" | "light""dark"Light palette override via theme-specific classes (e.g. .terminal-theme-grok-light). Site light mode (html:not(.dark)) also switches the active theme to its light tokens.
footerReactNode—Pinned footer slot — usually Input.
headerReactNode—Optional header slot above scroll content.
fillbooleanfalseStretch to fill a fixed-height window and scroll internally.
pinScrollBottombooleanfalsePin scroll content to the bottom as new lines appear.
bodyClassNamestring—Classes for the inner body layout wrapper.
headerActionReactNode—Optional control rendered at the end of the window chrome header.
classNamestring—Additional CSS classes on the window shell.
...propsHTMLDivElement—Standard div props.
advanced
TerminalBody
Deprecated — pass footer, header, fill, and pinScrollBottom to TerminalWindow instead.
PropTypeDefaultDescription
footerReactNode—Pinned footer slot — usually Input.
headerReactNode—Optional header slot above scroll content.
pinScrollBottombooleanfalsePin scroll content to the bottom as new lines appear.
fillbooleanfalseStretch to fill a fixed-height window and scroll internally.