The Signal Rail: A Deterministic Motion Grammar for Communicating Conversational Agent State in Terminal Interfaces

Modern conversational agents in terminal interfaces rely on text to communicate complex internal states like listening, thinking, or tool execution. When motion is used, it is typically limited to generic spinners or progress bars that convey only a single bit of information: that the system is alive. This forces users to constantly read labels to understand what an agent is doing, which is inefficient for peripheral monitoring and fails to distinguish between different types of activity, such as a stalled network call versus active processing.

The Signal Rail is a one-row terminal instrument designed to provide a rich, readable vocabulary of agent states through motion rather than color or text. It is governed by four core principles:

• Spatial Semantics: The rail is divided into input, processing, and output zones, mirroring the agent's pipeline. Movement direction is meaningful, with rightward motion indicating forward progress and leftward motion reserved for returning control to the user.
• Motion Grammar: Each of the twelve defined states (e.g., listening, thinking, speaking, error) is assigned a unique kinetic rule. For instance, listening expands from an origin, while speaking emits packets that travel rightward.
• Determinism: The display is a pure function of its inputs. This makes the UI testable using golden frames, ensuring that animations are reproducible and consistent across different terminals and sessions.
• Honesty: The rail prohibits decorative animations that imply progress where none exists, ensuring that the visual state always reflects the actual backend status.

By treating status indicators as a formal, deterministic grammar rather than a decorative widget, the Signal Rail aims to bring the discipline of aviation and railway signaling to software interfaces. This approach allows developers to build interfaces that are readable at a glance, accessible to users who cannot rely on color-coded information, and robust enough to be verified through automated testing. It shifts the burden of state communication from the user's cognitive load to a standardized, predictable visual language.