feat(tui): reduce animations

go.mod

@@ -19,6 +19,7 @@ require (
 	github.com/charmbracelet/colorprofile v0.3.3
 	github.com/charmbracelet/fang v0.4.3
 	github.com/charmbracelet/glamour/v2 v2.0.0-20250811143442-a27abb32f018
+	github.com/charmbracelet/lipgloss/v2 v2.0.0-beta.3.0.20251103214348-d3032608aa74
 	github.com/charmbracelet/log/v2 v2.0.0-20250226163916-c379e29ff706
 	github.com/charmbracelet/ultraviolet v0.0.0-20251105181648-75d1e37ff1bb
 	github.com/charmbracelet/x/ansi v0.10.3
@@ -88,7 +89,6 @@ require (
 	github.com/bahlo/generic-list-go v0.2.0 // indirect
 	github.com/buger/jsonparser v1.1.1 // indirect
 	github.com/charmbracelet/anthropic-sdk-go v0.0.0-20251024181547-21d6f3d9a904 // indirect
-	github.com/charmbracelet/lipgloss/v2 v2.0.0-beta.3.0.20251103214348-d3032608aa74 // indirect
 	github.com/charmbracelet/x/cellbuf v0.0.14-0.20250811133356-e0c5dbe5ea4a // indirect
 	github.com/charmbracelet/x/json v0.2.0 // indirect
 	github.com/charmbracelet/x/termios v0.1.1 // indirect

internal/config/config.go

@@ -143,8 +143,9 @@ type LSPConfig struct {
 }
 
 type TUIOptions struct {
-	CompactMode bool   `json:"compact_mode,omitempty" jsonschema:"description=Enable compact mode for the TUI interface,default=false"`
-	DiffMode    string `json:"diff_mode,omitempty" jsonschema:"description=Diff mode for the TUI interface,enum=unified,enum=split"`
+	CompactMode      bool   `json:"compact_mode,omitempty" jsonschema:"description=Enable compact mode for the TUI interface,default=false"`
+	DiffMode         string `json:"diff_mode,omitempty" jsonschema:"description=Diff mode for the TUI interface,enum=unified,enum=split"`
+	ReduceAnimations *bool  `json:"reduce_animations,omitempty" jsonschema:"description=Reduce animations in the TUI,default=false"`
 	// Here we can add themes later or any TUI related options
 	//
 

internal/config/load.go

@@ -74,6 +74,14 @@ func Load(workingDir, dataDir string, debug bool) (*Config, error) {
 		assignIfNil(&cfg.Options.TUI.Completions.MaxItems, items)
 	}
 
+	if isSSH() {
+		slog.Warn("Running over SSH, will enable reduce animations")
+		assignIfNil(&cfg.Options.TUI.ReduceAnimations, true)
+	}
+	if b, _ := strconv.ParseBool(os.Getenv("CRUSH_REDUCE_ANIMATIONS")); b {
+		assignIfNil(&cfg.Options.TUI.ReduceAnimations, true)
+	}
+
 	// Load known providers, this loads the config from catwalk
 	providers, err := Providers(cfg)
 	if err != nil {
@@ -701,3 +709,5 @@ func isInsideWorktree() bool {
 	).CombinedOutput()
 	return err == nil && strings.TrimSpace(string(bts)) == "true"
 }
+
+func isSSH() bool { return os.Getenv("SSH_TTY") != "" }

internal/format/spinner.go

@@ -19,7 +19,7 @@ type Spinner struct {
 
 type model struct {
 	cancel context.CancelFunc
-	anim   *anim.Anim
+	anim   anim.Spinner
 }
 
 func (m model) Init() tea.Cmd  { return m.anim.Init() }
@@ -35,8 +35,8 @@ func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 			return m, tea.Quit
 		}
 	}
-	mm, cmd := m.anim.Update(msg)
-	m.anim = mm.(*anim.Anim)
+	var cmd tea.Cmd
+	m.anim, cmd = m.anim.Update(msg)
 	return m, cmd
 }
 

internal/tui/components/anim/anim.go

@@ -16,7 +16,6 @@ import (
 	"github.com/lucasb-eyer/go-colorful"
 
 	"github.com/charmbracelet/crush/internal/csync"
-	"github.com/charmbracelet/crush/internal/tui/util"
 )
 
 const (
@@ -95,13 +94,18 @@ type Settings struct {
 	GradColorA  color.Color
 	GradColorB  color.Color
 	CycleColors bool
+	Static      bool
 }
 
-// Default settings.
-const ()
+// Spinner is a Bubble for a spinner.
+type Spinner interface {
+	Init() tea.Cmd
+	Update(tea.Msg) (Spinner, tea.Cmd)
+	View() string
+	SetLabel(string)
+}
 
-// Anim is a Bubble for an animated spinner.
-type Anim struct {
+type anim struct {
 	width            int
 	cyclingCharWidth int
 	label            *csync.Slice[string]
@@ -118,9 +122,16 @@ type Anim struct {
 	id               int
 }
 
-// New creates a new Anim instance with the specified width and label.
-func New(opts Settings) *Anim {
-	a := &Anim{}
+// New creates a new anim instance with the specified width and label.
+func New(opts Settings) Spinner {
+	if colorIsUnset(opts.LabelColor) {
+		opts.LabelColor = defaultLabelColor
+	}
+
+	if opts.Static {
+		return newStatic(opts.Label, opts.LabelColor)
+	}
+
 	// Validate settings.
 	if opts.Size < 1 {
 		opts.Size = defaultNumCyclingChars
@@ -131,10 +142,8 @@ func New(opts Settings) *Anim {
 	if colorIsUnset(opts.GradColorB) {
 		opts.GradColorB = defaultGradColorB
 	}
-	if colorIsUnset(opts.LabelColor) {
-		opts.LabelColor = defaultLabelColor
-	}
 
+	a := &anim{}
 	a.id = nextID()
 	a.startTime = time.Now()
 	a.cyclingCharWidth = opts.Size
@@ -255,7 +264,7 @@ func New(opts Settings) *Anim {
 }
 
 // SetLabel updates the label text and re-renders it.
-func (a *Anim) SetLabel(newLabel string) {
+func (a *anim) SetLabel(newLabel string) {
 	a.labelWidth = lipgloss.Width(newLabel)
 
 	// Update total width
@@ -269,7 +278,7 @@ func (a *Anim) SetLabel(newLabel string) {
 }
 
 // renderLabel renders the label with the current label color.
-func (a *Anim) renderLabel(label string) {
+func (a *anim) renderLabel(label string) {
 	if a.labelWidth > 0 {
 		// Pre-render the label.
 		labelRunes := []rune(label)
@@ -296,7 +305,7 @@ func (a *Anim) renderLabel(label string) {
 }
 
 // Width returns the total width of the animation.
-func (a *Anim) Width() (w int) {
+func (a *anim) Width() (w int) {
 	w = a.width
 	if a.labelWidth > 0 {
 		w += labelGapWidth + a.labelWidth
@@ -314,12 +323,10 @@ func (a *Anim) Width() (w int) {
 }
 
 // Init starts the animation.
-func (a *Anim) Init() tea.Cmd {
-	return a.Step()
-}
+func (a *anim) Init() tea.Cmd { return stepCmd(a.id) }
 
 // Update processes animation steps (or not).
-func (a *Anim) Update(msg tea.Msg) (util.Model, tea.Cmd) {
+func (a *anim) Update(msg tea.Msg) (Spinner, tea.Cmd) {
 	switch msg := msg.(type) {
 	case StepMsg:
 		if msg.id != a.id {
@@ -341,14 +348,14 @@ func (a *Anim) Update(msg tea.Msg) (util.Model, tea.Cmd) {
 		} else if !a.initialized.Load() && time.Since(a.startTime) >= maxBirthOffset {
 			a.initialized.Store(true)
 		}
-		return a, a.Step()
+		return a, stepCmd(a.id)
 	default:
 		return a, nil
 	}
 }
 
 // View renders the current state of the animation.
-func (a *Anim) View() string {
+func (a *anim) View() string {
 	var b strings.Builder
 	step := int(a.step.Load())
 	for i := range a.width {
@@ -381,10 +388,10 @@ func (a *Anim) View() string {
 	return b.String()
 }
 
-// Step is a command that triggers the next step in the animation.
-func (a *Anim) Step() tea.Cmd {
+// stepCmd is a command that triggers the next stepCmd in the animation.
+func stepCmd(id int) tea.Cmd {
 	return tea.Tick(time.Second/time.Duration(fps), func(t time.Time) tea.Msg {
-		return StepMsg{id: a.id}
+		return StepMsg{id: id}
 	})
 }
 

internal/tui/components/anim/static.go

@@ -0,0 +1,43 @@
+package anim
+
+import (
+	"cmp"
+	"image/color"
+
+	tea "charm.land/bubbletea/v2"
+	"github.com/charmbracelet/lipgloss/v2"
+)
+
+type noAnim struct {
+	Color    color.Color
+	rendered string
+	id       int
+}
+
+func newStatic(label string, foreground color.Color) Spinner {
+	a := &noAnim{Color: foreground}
+	a.SetLabel(label)
+	a.id = nextID()
+	return a
+}
+
+func (s *noAnim) SetLabel(label string) {
+	s.rendered = lipgloss.NewStyle().
+		Foreground(s.Color).
+		Render(cmp.Or(label, "Working") + ellipsisFrames[2])
+}
+
+func (s noAnim) Init() tea.Cmd { return stepCmd(s.id) }
+func (s *noAnim) View() string { return s.rendered }
+func (s *noAnim) Update(msg tea.Msg) (Spinner, tea.Cmd) {
+	switch msg := msg.(type) {
+	case StepMsg:
+		if msg.id != s.id {
+			// Reject messages that are not for this instance.
+			return s, nil
+		}
+		return s, stepCmd(s.id)
+	default:
+		return s, nil
+	}
+}

internal/tui/components/chat/messages/messages.go

@@ -54,7 +54,7 @@ type messageCmp struct {
 	// Core message data and state
 	message  message.Message // The underlying message content
 	spinning bool            // Whether to show loading animation
-	anim     *anim.Anim      // Animation component for loading states
+	anim     anim.Spinner    // Animation component for loading states
 
 	// Thinking viewport for displaying reasoning content
 	thinkingViewport viewport.Model
@@ -75,6 +75,7 @@ func NewMessageCmp(msg message.Message) MessageCmp {
 	m := &messageCmp{
 		message: msg,
 		anim: anim.New(anim.Settings{
+			Static:      isReduceAnimations(),
 			Size:        15,
 			GradColorA:  t.Primary,
 			GradColorB:  t.Secondary,
@@ -99,8 +100,8 @@ func (m *messageCmp) Update(msg tea.Msg) (util.Model, tea.Cmd) {
 	case anim.StepMsg:
 		m.spinning = m.shouldSpin()
 		if m.spinning {
-			u, cmd := m.anim.Update(msg)
-			m.anim = u.(*anim.Anim)
+			var cmd tea.Cmd
+			m.anim, cmd = m.anim.Update(msg)
 			return m, cmd
 		}
 	case tea.KeyPressMsg:
@@ -439,3 +440,11 @@ func (m *assistantSectionModel) IsSectionHeader() bool {
 func (m *messageCmp) ID() string {
 	return m.message.ID
 }
+
+func isReduceAnimations() bool {
+	cfg := config.Get()
+	return cfg.Options != nil &&
+		cfg.Options.TUI != nil &&
+		cfg.Options.TUI.ReduceAnimations != nil &&
+		*cfg.Options.TUI.ReduceAnimations
+}

internal/tui/components/chat/messages/tool.go

@@ -61,8 +61,8 @@ type toolCallCmp struct {
 	permissionGranted   bool
 
 	// Animation state for pending tool calls
-	spinning bool       // Whether to show loading animation
-	anim     util.Model // Animation component for pending states
+	spinning bool         // Whether to show loading animation
+	anim     anim.Spinner // Animation component for pending states
 
 	nestedToolCalls []ToolCallCmp // Nested tool calls for hierarchical display
 }
@@ -120,6 +120,7 @@ func NewToolCallCmp(parentMessageID string, tc message.ToolCall, permissions per
 	}
 	t := styles.CurrentTheme()
 	m.anim = anim.New(anim.Settings{
+		Static:      isReduceAnimations(),
 		Size:        15,
 		Label:       "Working",
 		GradColorA:  t.Primary,
@@ -129,6 +130,7 @@ func NewToolCallCmp(parentMessageID string, tc message.ToolCall, permissions per
 	})
 	if m.isNested {
 		m.anim = anim.New(anim.Settings{
+			Static:      isReduceAnimations(),
 			Size:        10,
 			GradColorA:  t.Primary,
 			GradColorB:  t.Secondary,
@@ -159,8 +161,8 @@ func (m *toolCallCmp) Update(msg tea.Msg) (util.Model, tea.Cmd) {
 			}
 		}
 		if m.spinning {
-			u, cmd := m.anim.Update(msg)
-			m.anim = u
+			var cmd tea.Cmd
+			m.anim, cmd = m.anim.Update(msg)
 			cmds = append(cmds, cmd)
 		}
 		return m, tea.Batch(cmds...)