@cyperx/clawforge 1.2.0

package/tui/dashboard.go

@@ -0,0 +1,219 @@
+package main
+
+import (
+	"fmt"
+	"strings"
+
+	"charm.land/lipgloss/v2"
+)
+
+// Column widths for the agent table.
+const (
+	colID       = 5
+	colMode     = 8
+	colStatus   = 10
+	colRepo     = 12
+	colModel    = 12
+	colBranch   = 18
+	colTask     = 24
+	colCost     = 8
+	colCI       = 4
+	colConflict = 5
+)
+
+// renderDashboard renders the main dashboard view.
+func renderDashboard(m Model) string {
+	var b strings.Builder
+
+	// Header.
+	title := headerStyle.Render("⚒️  ClawForge Dashboard")
+	viewLabel := m.viewMode
+	if viewLabel == "" {
+		viewLabel = "all"
+	}
+	b.WriteString(title)
+	b.WriteString("  ")
+	b.WriteString(lipgloss.NewStyle().Faint(true).Render("view: " + viewLabel + " (1/2/3, tab)"))
+	b.WriteString("\n\n")
+
+	// Filter bar (if active).
+	if m.filterMode {
+		b.WriteString(RenderFilterBar(m))
+		b.WriteString("\n\n")
+	}
+
+	agents := m.filteredAgents()
+
+	// Table header row.
+	hdr := tableHeaderStyle.Render(
+		padRight("ID", colID) +
+			padRight("Mode", colMode) +
+			padRight("Status", colStatus) +
+			padRight("Repo", colRepo) +
+			padRight("Model", colModel) +
+			padRight("Branch", colBranch) +
+			padRight("Task", colTask) +
+			padRight("Cost", colCost) +
+			padRight("CI", colCI) +
+			padRight("Cnfl", colConflict),
+	)
+	b.WriteString(hdr)
+	b.WriteString("\n")
+
+	// Separator.
+	totalWidth := colID + colMode + colStatus + colRepo + colModel + colBranch + colTask + colCost + colCI + colConflict
+	b.WriteString(separatorStyle.Render(strings.Repeat("─", totalWidth)))
+	b.WriteString("\n")
+
+	if len(agents) == 0 {
+		empty := lipgloss.NewStyle().Faint(true).Render("  No agents found.")
+		b.WriteString(empty)
+		b.WriteString("\n")
+	} else {
+		// Determine how many rows to show based on terminal height.
+		maxRows := len(agents)
+		if m.height > 0 {
+			// Reserve lines for header(2) + table header(1) + separator(1) + footer(2) + steer(1) + padding(1).
+			available := m.height - 8
+			if m.filterMode {
+				available -= 2
+			}
+			if available < 1 {
+				available = 1
+			}
+			if maxRows > available {
+				maxRows = available
+			}
+		}
+
+		// Scroll offset: keep selected row visible.
+		offset := 0
+		if m.selected >= maxRows {
+			offset = m.selected - maxRows + 1
+		}
+
+		for i := offset; i < offset+maxRows && i < len(agents); i++ {
+			a := agents[i]
+			row := renderAgentRow(a)
+			if i == m.selected {
+				row = selectedRowStyle.Render(row)
+			}
+			b.WriteString(row)
+			b.WriteString("\n")
+		}
+	}
+
+	// Preview pane (if active).
+	if m.showPreview {
+		agents := m.filteredAgents()
+		if len(agents) > 0 && m.selected < len(agents) {
+			selAgent := agents[m.selected]
+			b.WriteString("\n")
+			previewHeader := lipgloss.NewStyle().Foreground(lipgloss.Color("#FFA500")).Bold(true).Render(
+				fmt.Sprintf("── Preview: %s ──", selAgent.ID))
+			b.WriteString(previewHeader)
+			b.WriteString("\n")
+			if selAgent.Preview != "" {
+				b.WriteString(lipgloss.NewStyle().Faint(true).Render(selAgent.Preview))
+			} else {
+				b.WriteString(lipgloss.NewStyle().Faint(true).Render("(no output / not running)"))
+			}
+			b.WriteString("\n")
+		}
+	}
+
+	// Steer input (if active).
+	if m.steerMode {
+		b.WriteString("\n")
+		b.WriteString(RenderSteerInput(m))
+		b.WriteString("\n")
+	}
+
+	// Help overlay.
+	if m.showHelp {
+		b.WriteString("\n")
+		b.WriteString(renderHelpOverlay(m.width))
+		b.WriteString("\n")
+	}
+
+	// Footer status bar.
+	b.WriteString("\n")
+	b.WriteString(renderStatusBar(m))
+
+	return b.String()
+}
+
+// renderAgentRow formats a single agent as a table row.
+func renderAgentRow(a Agent) string {
+	id := a.ID
+	if a.ShortID > 0 {
+		id = fmt.Sprintf("#%d", a.ShortID)
+	}
+
+	status := statusIndicator(a.Status) + " " + a.Status
+
+	conflictStr := "-"
+	if a.Conflicts > 0 {
+		conflictStr = fmt.Sprintf("%d", a.Conflicts)
+	}
+
+	return padRight(truncate(id, colID), colID) +
+		padRight(truncate(a.Mode, colMode), colMode) +
+		padRight(truncate(status, colStatus), colStatus) +
+		padRight(truncate(a.Repo, colRepo), colRepo) +
+		padRight(truncate(a.Model, colModel), colModel) +
+		padRight(truncate(a.Branch, colBranch), colBranch) +
+		padRight(truncate(a.Task, colTask), colTask) +
+		padRight(truncate(a.Cost, colCost), colCost) +
+		padRight(truncate(a.CI, colCI), colCI) +
+		padRight(truncate(conflictStr, colConflict), colConflict)
+}
+
+// renderStatusBar renders the footer status bar.
+func renderStatusBar(m Model) string {
+	agents := m.filteredAgents()
+	total := len(agents)
+	running := 0
+	var totalCost float64
+
+	for _, a := range agents {
+		if a.Status == "running" {
+			running++
+		}
+		// Parse cost for summary.
+		if a.Cost != "-" && a.Cost != "" {
+			var c float64
+			fmt.Sscanf(a.Cost, "$%f", &c)
+			totalCost += c
+		}
+	}
+
+	costStr := "-"
+	if totalCost > 0 {
+		costStr = fmt.Sprintf("$%.2f", totalCost)
+	}
+
+	bar := fmt.Sprintf(" %d agents | %d running | %s total | view:%s | j/k navigate | n nudge | ? help | q quit",
+		total, running, costStr, m.viewMode)
+
+	return statusBarStyle.Render(bar)
+}
+
+// truncate shortens a string to maxLen, adding "…" if needed.
+func truncate(s string, maxLen int) string {
+	if len(s) <= maxLen {
+		return s
+	}
+	if maxLen <= 1 {
+		return "…"
+	}
+	return s[:maxLen-1] + "…"
+}
+
+// padRight pads a string with spaces to the given width.
+func padRight(s string, width int) string {
+	if len(s) >= width {
+		return s
+	}
+	return s + strings.Repeat(" ", width-len(s))
+}

package/tui/filter.go

@@ -0,0 +1,68 @@
+package main
+
+import (
+	"strings"
+
+	tea "charm.land/bubbletea/v2"
+	"charm.land/lipgloss/v2"
+)
+
+// handleFilterKey processes key input while in filter mode.
+func handleFilterKey(m Model, key string) (Model, tea.Cmd) {
+	switch key {
+	case "esc":
+		m.filterMode = false
+		m.filter = ""
+		m.selected = 0
+		return m, nil
+	case "enter":
+		m.filterMode = false
+		return m, nil
+	case "backspace":
+		if len(m.filter) > 0 {
+			m.filter = m.filter[:len(m.filter)-1]
+			// Reset selection when filter changes.
+			m.selected = 0
+		}
+		return m, nil
+	default:
+		if len(key) == 1 {
+			m.filter += key
+			m.selected = 0
+		} else if key == "space" {
+			m.filter += " "
+			m.selected = 0
+		}
+		return m, nil
+	}
+}
+
+// FilterAgents returns agents matching the query via case-insensitive substring
+// match across all display fields.
+func FilterAgents(agents []Agent, query string) []Agent {
+	if query == "" {
+		return agents
+	}
+	q := strings.ToLower(query)
+	var results []Agent
+	for _, a := range agents {
+		haystack := strings.ToLower(
+			a.ID + " " + a.Mode + " " + a.Status + " " + a.Branch + " " + a.Description,
+		)
+		if strings.Contains(haystack, q) {
+			results = append(results, a)
+		}
+	}
+	return results
+}
+
+// RenderFilterBar renders the filter input bar shown at the top of the screen.
+func RenderFilterBar(m Model) string {
+	prompt := "/ " + m.filter
+	cursor := "█"
+
+	return lipgloss.NewStyle().
+		Foreground(lipgloss.Color("#FFA500")).
+		Bold(true).
+		Render(prompt + cursor)
+}

package/tui/go.mod

@@ -0,0 +1,25 @@
+module github.com/cyperx84/clawforge/tui
+
+go 1.25.0
+
+require (
+	charm.land/bubbletea/v2 v2.0.1 // indirect
+	charm.land/lipgloss/v2 v2.0.0 // indirect
+	github.com/charmbracelet/bubbles v1.0.0 // indirect
+	github.com/charmbracelet/colorprofile v0.4.2 // indirect
+	github.com/charmbracelet/ultraviolet v0.0.0-20260205113103-524a6607adb8 // indirect
+	github.com/charmbracelet/x/ansi v0.11.6 // indirect
+	github.com/charmbracelet/x/term v0.2.2 // indirect
+	github.com/charmbracelet/x/termios v0.1.1 // indirect
+	github.com/charmbracelet/x/windows v0.2.2 // indirect
+	github.com/clipperhouse/displaywidth v0.11.0 // indirect
+	github.com/clipperhouse/stringish v0.1.1 // indirect
+	github.com/clipperhouse/uax29/v2 v2.7.0 // indirect
+	github.com/lucasb-eyer/go-colorful v1.3.0 // indirect
+	github.com/mattn/go-runewidth v0.0.19 // indirect
+	github.com/muesli/cancelreader v0.2.2 // indirect
+	github.com/rivo/uniseg v0.4.7 // indirect
+	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
+	golang.org/x/sync v0.19.0 // indirect
+	golang.org/x/sys v0.41.0 // indirect
+)

package/tui/go.sum

@@ -0,0 +1,46 @@
+charm.land/bubbletea/v2 v2.0.1 h1:B8e9zzK7x9JJ+XvHGF4xnYu9Xa0E0y0MyggY6dbaCfQ=
+charm.land/bubbletea/v2 v2.0.1/go.mod h1:3LRff2U4WIYXy7MTxfbAQ+AdfM3D8Xuvz2wbsOD9OHQ=
+charm.land/lipgloss/v2 v2.0.0 h1:sd8N/B3x892oiOjFfBQdXBQp3cAkvjGaU5TvVZC3ivo=
+charm.land/lipgloss/v2 v2.0.0/go.mod h1:w6SnmsBFBmEFBodiEDurGS/sdUY/u1+v72DqUzc6J14=
+github.com/charmbracelet/bubbles v1.0.0 h1:12J8/ak/uCZEMQ6KU7pcfwceyjLlWsDLAxB5fXonfvc=
+github.com/charmbracelet/bubbles v1.0.0/go.mod h1:9d/Zd5GdnauMI5ivUIVisuEm3ave1XwXtD1ckyV6r3E=
+github.com/charmbracelet/colorprofile v0.4.1 h1:a1lO03qTrSIRaK8c3JRxJDZOvhvIeSco3ej+ngLk1kk=
+github.com/charmbracelet/colorprofile v0.4.1/go.mod h1:U1d9Dljmdf9DLegaJ0nGZNJvoXAhayhmidOdcBwAvKk=
+github.com/charmbracelet/colorprofile v0.4.2 h1:BdSNuMjRbotnxHSfxy+PCSa4xAmz7szw70ktAtWRYrY=
+github.com/charmbracelet/colorprofile v0.4.2/go.mod h1:0rTi81QpwDElInthtrQ6Ni7cG0sDtwAd4C4le060fT8=
+github.com/charmbracelet/ultraviolet v0.0.0-20260205113103-524a6607adb8 h1:eyFRbAmexyt43hVfeyBofiGSEmJ7krjLOYt/9CF5NKA=
+github.com/charmbracelet/ultraviolet v0.0.0-20260205113103-524a6607adb8/go.mod h1:SQpCTRNBtzJkwku5ye4S3HEuthAlGy2n9VXZnWkEW98=
+github.com/charmbracelet/x/ansi v0.11.6 h1:GhV21SiDz/45W9AnV2R61xZMRri5NlLnl6CVF7ihZW8=
+github.com/charmbracelet/x/ansi v0.11.6/go.mod h1:2JNYLgQUsyqaiLovhU2Rv/pb8r6ydXKS3NIttu3VGZQ=
+github.com/charmbracelet/x/term v0.2.2 h1:xVRT/S2ZcKdhhOuSP4t5cLi5o+JxklsoEObBSgfgZRk=
+github.com/charmbracelet/x/term v0.2.2/go.mod h1:kF8CY5RddLWrsgVwpw4kAa6TESp6EB5y3uxGLeCqzAI=
+github.com/charmbracelet/x/termios v0.1.1 h1:o3Q2bT8eqzGnGPOYheoYS8eEleT5ZVNYNy8JawjaNZY=
+github.com/charmbracelet/x/termios v0.1.1/go.mod h1:rB7fnv1TgOPOyyKRJ9o+AsTU/vK5WHJ2ivHeut/Pcwo=
+github.com/charmbracelet/x/windows v0.2.2 h1:IofanmuvaxnKHuV04sC0eBy/smG6kIKrWG2/jYn2GuM=
+github.com/charmbracelet/x/windows v0.2.2/go.mod h1:/8XtdKZzedat74NQFn0NGlGL4soHB0YQZrETF96h75k=
+github.com/clipperhouse/displaywidth v0.9.0 h1:Qb4KOhYwRiN3viMv1v/3cTBlz3AcAZX3+y9OLhMtAtA=
+github.com/clipperhouse/displaywidth v0.9.0/go.mod h1:aCAAqTlh4GIVkhQnJpbL0T/WfcrJXHcj8C0yjYcjOZA=
+github.com/clipperhouse/displaywidth v0.11.0 h1:lBc6kY44VFw+TDx4I8opi/EtL9m20WSEFgwIwO+UVM8=
+github.com/clipperhouse/displaywidth v0.11.0/go.mod h1:bkrFNkf81G8HyVqmKGxsPufD3JhNl3dSqnGhOoSD/o0=
+github.com/clipperhouse/stringish v0.1.1 h1:+NSqMOr3GR6k1FdRhhnXrLfztGzuG+VuFDfatpWHKCs=
+github.com/clipperhouse/stringish v0.1.1/go.mod h1:v/WhFtE1q0ovMta2+m+UbpZ+2/HEXNWYXQgCt4hdOzA=
+github.com/clipperhouse/uax29/v2 v2.5.0 h1:x7T0T4eTHDONxFJsL94uKNKPHrclyFI0lm7+w94cO8U=
+github.com/clipperhouse/uax29/v2 v2.5.0/go.mod h1:Wn1g7MK6OoeDT0vL+Q0SQLDz/KpfsVRgg6W7ihQeh4g=
+github.com/clipperhouse/uax29/v2 v2.7.0 h1:+gs4oBZ2gPfVrKPthwbMzWZDaAFPGYK72F0NJv2v7Vk=
+github.com/clipperhouse/uax29/v2 v2.7.0/go.mod h1:EFJ2TJMRUaplDxHKj1qAEhCtQPW2tJSwu5BF98AuoVM=
+github.com/lucasb-eyer/go-colorful v1.3.0 h1:2/yBRLdWBZKrf7gB40FoiKfAWYQ0lqNcbuQwVHXptag=
+github.com/lucasb-eyer/go-colorful v1.3.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
+github.com/mattn/go-runewidth v0.0.19 h1:v++JhqYnZuu5jSKrk9RbgF5v4CGUjqRfBm05byFGLdw=
+github.com/mattn/go-runewidth v0.0.19/go.mod h1:XBkDxAl56ILZc9knddidhrOlY5R/pDhgLpndooCuJAs=
+github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
+github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
+github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
+github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
+golang.org/x/sync v0.19.0 h1:vV+1eWNmZ5geRlYjzm2adRgW2/mcpevXNg50YZtPCE4=
+golang.org/x/sync v0.19.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=
+golang.org/x/sys v0.40.0 h1:DBZZqJ2Rkml6QMQsZywtnjnnGvHza6BTfYFWY9kjEWQ=
+golang.org/x/sys v0.40.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/sys v0.41.0 h1:Ivj+2Cp/ylzLiEU89QhWblYnOE9zerudt9Ftecq2C6k=
+golang.org/x/sys v0.41.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=

package/tui/keybindings.go

@@ -0,0 +1,229 @@
+package main
+
+import (
+	"fmt"
+	"os/exec"
+	"strings"
+
+	tea "charm.land/bubbletea/v2"
+)
+
+// stopDoneMsg is sent when a stop command finishes.
+type stopDoneMsg struct{ err error }
+
+// attachDoneMsg is sent when an attach (tmux) command finishes.
+type attachDoneMsg struct{ err error }
+
+// nudgeDoneMsg is sent when a nudge command finishes.
+type nudgeDoneMsg struct{ err error }
+
+// handleKeyPress dispatches key events to the appropriate handler based on
+// current mode (filter, steer, or normal dashboard).
+func handleKeyPress(m Model, msg tea.KeyPressMsg) (Model, tea.Cmd) {
+	key := msg.String()
+
+	// If in filter mode, delegate to filter handler.
+	if m.filterMode {
+		return handleFilterKey(m, key)
+	}
+
+	// If in steer mode, delegate to steer handler.
+	if m.steerMode {
+		return handleSteerKey(m, key)
+	}
+
+	// If confirming stop, handle y/n.
+	if m.confirmStop {
+		return handleConfirmStop(m, key)
+	}
+
+	// Normal dashboard mode.
+	agents := m.filteredAgents()
+	count := len(agents)
+
+	switch key {
+	case "q", "ctrl+c":
+		return m, tea.Quit
+
+	case "j", "down":
+		if count > 0 && m.selected < count-1 {
+			m.selected++
+		}
+		return m, nil
+
+	case "k", "up":
+		if m.selected > 0 {
+			m.selected--
+		}
+		return m, nil
+
+	case "g":
+		m.selected = 0
+		return m, nil
+
+	case "G":
+		if count > 0 {
+			m.selected = count - 1
+		}
+		return m, nil
+
+	case "enter":
+		// Attach to selected agent's tmux session.
+		if count > 0 {
+			agent := agents[m.selected]
+			session := agent.TmuxSession
+			if session == "" {
+				session = "clawforge-" + agent.ID
+			}
+			cmd := exec.Command("tmux", "attach-session", "-t", session)
+			return m, tea.ExecProcess(cmd, func(err error) tea.Msg {
+				return attachDoneMsg{err}
+			})
+		}
+		return m, nil
+
+	case "s":
+		// Open steer input modal.
+		if count > 0 {
+			m.steerMode = true
+			m.steerInput = ""
+		}
+		return m, nil
+
+	case "x":
+		// Stop selected agent (with confirmation).
+		if count > 0 {
+			m.confirmStop = true
+		}
+		return m, nil
+
+	case "/":
+		// Open filter input.
+		m.filterMode = true
+		m.filter = ""
+		return m, nil
+
+	case "1":
+		m.viewMode = "all"
+		m.selected = 0
+		return m, nil
+
+	case "2":
+		m.viewMode = "running"
+		m.selected = 0
+		return m, nil
+
+	case "3":
+		m.viewMode = "finished"
+		m.selected = 0
+		return m, nil
+
+	case "tab":
+		if m.viewMode == "all" {
+			m.viewMode = "running"
+		} else if m.viewMode == "running" {
+			m.viewMode = "finished"
+		} else {
+			m.viewMode = "all"
+		}
+		m.selected = 0
+		return m, nil
+
+	case "r":
+		// Force refresh.
+		m.agents = LoadAgents()
+		// Clamp selection.
+		filtered := m.filteredAgents()
+		if m.selected >= len(filtered) {
+			m.selected = max(0, len(filtered)-1)
+		}
+		return m, nil
+
+	case "p":
+		m.showPreview = !m.showPreview
+		return m, nil
+
+	case "n":
+		// Nudge selected running agent with a lightweight progress prompt.
+		if count > 0 {
+			agent := agents[m.selected]
+			if agent.Status == "running" || agent.Status == "spawned" {
+				cmd := exec.Command("clawforge", "steer", agent.ID, "Quick nudge: share current progress, blockers, and ETA.")
+				return m, tea.ExecProcess(cmd, func(err error) tea.Msg {
+					return nudgeDoneMsg{err}
+				})
+			}
+		}
+		return m, nil
+
+	case "?":
+		m.showHelp = !m.showHelp
+		return m, nil
+
+	case "esc":
+		// Close any overlay.
+		if m.showHelp {
+			m.showHelp = false
+		}
+		return m, nil
+	}
+
+	return m, nil
+}
+
+// handleConfirmStop processes y/n when confirming an agent stop.
+func handleConfirmStop(m Model, key string) (Model, tea.Cmd) {
+	switch key {
+	case "y", "Y":
+		agents := m.filteredAgents()
+		if len(agents) > 0 {
+			agent := agents[m.selected]
+			m.confirmStop = false
+			cmd := exec.Command("clawforge", "stop", agent.ID, "--yes")
+			return m, tea.ExecProcess(cmd, func(err error) tea.Msg {
+				return stopDoneMsg{err}
+			})
+		}
+		m.confirmStop = false
+		return m, nil
+	case "n", "N", "esc":
+		m.confirmStop = false
+		return m, nil
+	}
+	return m, nil
+}
+
+// renderHelpOverlay renders the keybinding help overlay.
+func renderHelpOverlay(width int) string {
+	bindings := []struct {
+		key  string
+		desc string
+	}{
+		{"j/k", "Navigate agent list"},
+		{"Enter", "Attach to selected agent's tmux session"},
+		{"s", "Steer selected agent (prompts for message)"},
+		{"x", "Stop selected agent"},
+		{"/", "Filter agents"},
+		{"1/2/3", "Views: all / running / finished"},
+		{"Tab", "Cycle views"},
+		{"n", "Nudge selected running agent"},
+		{"p", "Toggle output preview pane"},
+		{"r", "Force refresh"},
+		{"g/G", "Go to top/bottom"},
+		{"?", "Toggle help overlay"},
+		{"Esc", "Close modal/overlay"},
+		{"q", "Quit dashboard"},
+	}
+
+	var lines []string
+	lines = append(lines, headerStyle.Render("Keybindings"))
+	lines = append(lines, "")
+
+	for _, b := range bindings {
+		keyStr := fmt.Sprintf("  %-10s", b.key)
+		lines = append(lines, keyStr+b.desc)
+	}
+
+	content := strings.Join(lines, "\n")
+	return helpOverlayStyle.Render(content)
+}

package/tui/main.go

@@ -0,0 +1,61 @@
+package main
+
+import (
+	"fmt"
+	"os"
+
+	tea "charm.land/bubbletea/v2"
+	"github.com/charmbracelet/x/term"
+)
+
+const usageText = `Usage: clawforge dashboard [options]
+
+Live terminal UI for monitoring all ClawForge agents.
+
+Options:
+  --no-anim    Skip startup animation
+  --help       Show this help
+
+Keybindings:
+  j/k          Navigate agent list
+  Enter        Attach to selected agent's tmux session
+  s            Steer selected agent (prompts for message)
+  x            Stop selected agent
+  /            Filter agents
+  1/2/3        Views: all / running / finished
+  Tab          Cycle views
+  n            Nudge selected running agent
+  p            Toggle output preview pane
+  r            Force refresh
+  ?            Show help overlay
+  q            Quit dashboard`
+
+func main() {
+	noAnim := false
+	for _, arg := range os.Args[1:] {
+		switch arg {
+		case "--help", "-h":
+			fmt.Println(usageText)
+			os.Exit(0)
+		case "--no-anim":
+			noAnim = true
+		default:
+			fmt.Fprintf(os.Stderr, "Unknown option: %s\n", arg)
+			fmt.Fprintln(os.Stderr, usageText)
+			os.Exit(1)
+		}
+	}
+
+	// If stdin or stdout is not a terminal, show help and exit (for CI/scripting).
+	if !term.IsTerminal(os.Stdin.Fd()) || !term.IsTerminal(os.Stdout.Fd()) {
+		fmt.Println(usageText)
+		os.Exit(0)
+	}
+
+	m := NewModel(noAnim)
+	p := tea.NewProgram(m)
+	if _, err := p.Run(); err != nil {
+		fmt.Fprintf(os.Stderr, "Error: %v\n", err)
+		os.Exit(1)
+	}
+}