Nity Brand — Overview

The brand layer provides Nity's presence and identity in the terminal UI. Located at extensions/nity/brand/ and extensions/nity/tui/.

Components

Brand Voice State to Brand TUI Surfaces

Voice — Brand voice generation from session state
State-to-Brand — Maps agent state to brand presence
TUI Presence — Presence indicator, loop status display, memory banner

Design Philosophy

Nity's brand is not decoration — it communicates system state. Every visual element in the TUI has functional meaning:

Element	Communicates
Presence indicator	Current agent state (idle, active, thinking, executing)
Loop status	Autonomous iteration progress and circuit breaker state
Memory banner	Brain load status, episode count, memory health

The brand layer follows the "Glass Box" principle from Orion-OS. Users should always understand what the system is doing through its visual presence, without needing to read logs.

Architecture

session state (coordinator.ts)
  └── state-to-brand.ts
       └── maps internal states → brand states
            └── voice.ts
                 └── generates message text
                      └── TUI components
                           ├── presence-indicator.ts
                           ├── loop-status.ts
                           └── memory-banner.ts

Brand States

Internal State	Brand State	Visual
`idle`	Resting	Muted, subtle presence
`active`	Working	Active indicator, current task
`thinking`	Contemplating	Animated pulse, processing message
`executing`	Building	Progress indicator, iteration count
`error`	Recovering	Attention signal, error summary
`complete`	Satisfied	Completion mark, work summary

Architecture Consciousness

Nity Loop Brand Voice