Guide

How Claude Code statusLine works

Claude Code runs a local command, sends session JSON on stdin, and displays the first line printed to stdout.

Runtime model

Terminal Pro generates a local Node script. It reads fields such as model, context_window, effort, rate_limits, cost, workspace, and worktree directly from the JSON payload Claude Code provides.

Responsive output

Claude Code exposes terminal width through COLUMNS. The runtime uses it to hide bars, compact labels, and drop optional device metrics before the line wraps.

Safe install

The generated statusLine command runs a local file under ~/.claude/terminal-pro. There is no npm package download when a Claude Code session starts.