feat: show version in header with upgrade notification (#215)

Display the current version next to the tagline in the header banner.
On startup, asynchronously check the latest GitHub release — if a
newer version exists, show an upgrade nudge (e.g., '⬆ v0.9.0 available')
in amber next to the version.

- Thread version from cmd.Version → NewModel → ProgramContext → header
- Add checkLatestVersion() command using gh api (non-blocking)
- Header.renderVersionBadge() shows version + optional upgrade nudge

Fixes #214

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: maxbeizer

cmd/root.go

@@ -31,7 +31,7 @@ terminal UI for visualizing and managing GitHub Copilot coding agent sessions.
 		data.SetDebug(debugFlag)
 
 		// Create the Bubble Tea program
-		model := tui.NewModel(repoFlag, debugFlag, demoFlag, snapshotFlag)
+		model := tui.NewModel(repoFlag, debugFlag, demoFlag, snapshotFlag, Version)
 		p := tea.NewProgram(model, tea.WithAltScreen(), tea.WithMouseAllMotion())
 
 		// Run the program

internal/tui/commands.go

@@ -67,6 +67,10 @@ type errMsg struct {
 	err error
 }
 
+type latestVersionMsg struct {
+	version string // e.g., "v0.8.2"
+}
+
 type conversationLoadedMsg struct {
 	messages []conversation.ChatMessage
 }
@@ -471,3 +475,16 @@ func (m Model) fetchGitDiff(workDir string) tea.Cmd {
 		return gitDiffLoadedMsg{result}
 	}
 }
+
+// checkLatestVersion queries GitHub for the latest release tag.
+func checkLatestVersion() tea.Msg {
+	out, err := exec.Command("gh", "api",
+		"repos/maxbeizer/gh-agent-viz/releases/latest",
+		"--jq", ".tag_name",
+	).Output()
+	if err != nil {
+		return latestVersionMsg{} // silently ignore
+	}
+	tag := strings.TrimSpace(string(out))
+	return latestVersionMsg{version: tag}
+}

internal/tui/components/header/header.go

@@ -42,6 +42,8 @@ type Model struct {
 	tabCount       lipgloss.Style
 	title          string
 	tagline        string
+	version        string
+	upgradeVersion string // non-empty when a newer version is available
 	filter         *string
 	counts         FilterCounts
 	useAsciiHeader bool
@@ -59,21 +61,27 @@ const bannerWidth = 27
 const minHeightForBanner = 15
 
 // New creates a new header model
-func New(titleStyle, tabActive, tabInactive, tabCount lipgloss.Style, title string, filter *string, useAsciiHeader bool) Model {
+func New(titleStyle, tabActive, tabInactive, tabCount lipgloss.Style, title string, filter *string, useAsciiHeader bool, version string) Model {
 	return Model{
 		titleStyle:     titleStyle,
 		tabActive:      tabActive,
 		tabInactive:    tabInactive,
 		tabCount:       tabCount,
 		title:          title,
 		tagline:        taglines[rand.Intn(len(taglines))],
+		version:        version,
 		filter:         filter,
 		useAsciiHeader: useAsciiHeader,
 		width:          80,
 		height:         24,
 	}
 }
 
+// SetUpgradeVersion sets the latest available version for the upgrade nudge.
+func (m *Model) SetUpgradeVersion(v string) {
+	m.upgradeVersion = v
+}
+
 // SetSize updates the terminal dimensions for responsive layout
 func (m *Model) SetSize(width, height int) {
 	m.width = width
@@ -131,13 +139,19 @@ func (m Model) View() string {
 			Bold(true).
 			Foreground(m.titleStyle.GetForeground())
 		styledBanner := bannerStyle.Render(Banner)
+
+		// Build info block: tagline + version
+		var infoParts []string
 		if m.tagline != "" {
 			tagStyle := lipgloss.NewStyle().
 				Foreground(lipgloss.AdaptiveColor{Light: "245", Dark: "250"}).
 				Italic(true)
-			tagBlock := tagStyle.Render(m.tagline)
-			styledBanner = lipgloss.JoinHorizontal(lipgloss.Center, styledBanner, "  ", tagBlock)
+			infoParts = append(infoParts, tagStyle.Render(m.tagline))
 		}
+		infoParts = append(infoParts, m.renderVersionBadge())
+		infoBlock := strings.Join(infoParts, "\n")
+
+		styledBanner = lipgloss.JoinHorizontal(lipgloss.Center, styledBanner, "  ", infoBlock)
 		return styledBanner + "\n" + tabLine + "\n" + separator + "\n"
 	}
 
@@ -161,12 +175,16 @@ func (m Model) ViewBannerOnly() string {
 			Bold(true).
 			Foreground(m.titleStyle.GetForeground())
 		styledBanner := bannerStyle.Render(Banner)
+
+		var infoParts []string
 		if m.tagline != "" {
 			tagStyle := lipgloss.NewStyle().
 				Foreground(lipgloss.AdaptiveColor{Light: "245", Dark: "250"}).
 				Italic(true)
-			styledBanner = lipgloss.JoinHorizontal(lipgloss.Center, styledBanner, "  ", tagStyle.Render(m.tagline))
+			infoParts = append(infoParts, tagStyle.Render(m.tagline))
 		}
+		infoParts = append(infoParts, m.renderVersionBadge())
+		styledBanner = lipgloss.JoinHorizontal(lipgloss.Center, styledBanner, "  ", strings.Join(infoParts, "\n"))
 		return styledBanner + "\n" + separator + "\n"
 	}
 
@@ -178,3 +196,19 @@ func (m Model) ViewBannerOnly() string {
 
 	return separator + "\n"
 }
+
+// renderVersionBadge returns the version label, with an upgrade nudge if available.
+func (m Model) renderVersionBadge() string {
+	if m.version == "" {
+		return ""
+	}
+	versionStyle := lipgloss.NewStyle().Faint(true)
+	badge := versionStyle.Render("v" + strings.TrimPrefix(m.version, "v"))
+
+	if m.upgradeVersion != "" && m.upgradeVersion != m.version {
+		upgradeStyle := lipgloss.NewStyle().
+			Foreground(lipgloss.AdaptiveColor{Light: "214", Dark: "214"})
+		badge += "  " + upgradeStyle.Render("⬆ "+m.upgradeVersion+" available")
+	}
+	return badge
+}

internal/tui/components/header/header_test.go

@@ -9,7 +9,7 @@ import (
 
 func newTestModel(title string, filter *string) Model {
 	s := lipgloss.NewStyle()
-	return New(s, s, s, s, title, filter, false)
+	return New(s, s, s, s, title, filter, false, "v0.8.2")
 }
 
 func TestNew(t *testing.T) {
@@ -94,7 +94,7 @@ func TestView_EndsWithNewline(t *testing.T) {
 
 func newTestModelWithBanner(title string, filter *string, useAscii bool) Model {
 	s := lipgloss.NewStyle()
-	m := New(s, s, s, s, title, filter, useAscii)
+	m := New(s, s, s, s, title, filter, useAscii, "v0.8.2")
 	m.SetSize(80, 24)
 	return m
 }

internal/tui/context.go

@@ -20,6 +20,7 @@ type ProgramContext struct {
 	Height       int
 	Error        error
 	Debug        bool
+	Version      string
 	StatusFilter string // "all", "attention", "active", "completed", "failed"
 	Counts       FilterCounts
 }

internal/tui/ui.go

@@ -81,9 +81,10 @@ type Model struct {
 }
 
 // NewModel creates a new TUI model
-func NewModel(repo string, debug bool, demo bool, snapshotPath string) Model {
+func NewModel(repo string, debug bool, demo bool, snapshotPath string, version string) Model {
 	ctx := NewProgramContext()
 	ctx.Debug = debug
+	ctx.Version = version
 	cfg, err := config.Load("")
 	if err == nil {
 		ctx.Config = cfg
@@ -145,7 +146,7 @@ func NewModel(repo string, debug bool, demo bool, snapshotPath string) Model {
 		ctx:         ctx,
 		theme:       theme,
 		keys:        keys,
-		header:      header.New(theme.Title, theme.TabActive, theme.TabInactive, theme.TabCount, "⚡ Agent Sessions", &ctx.StatusFilter, ctx.Config.AsciiHeaderEnabled()),
+		header:      header.New(theme.Title, theme.TabActive, theme.TabInactive, theme.TabCount, "⚡ Agent Sessions", &ctx.StatusFilter, ctx.Config.AsciiHeaderEnabled(), ctx.Version),
 		footer:      footer.New(theme.Footer, footerKeys),
 		help:        help.New(),
 		taskList:       tasklist.NewWithStore(theme.Title, theme.TableHeader, theme.TableRow, theme.TableRowSelected, theme.SectionHeader, StatusIcon, animIconFunc, dismissedStore),
@@ -179,6 +180,7 @@ func (m Model) Init() tea.Cmd {
 		m.loadSpinner.Tick,
 		m.fetchLocalSessions,  // Phase 1: fast, shows content immediately
 		m.fetchAgentTasks,     // Phase 2: runs concurrently, returns when API responds
+		checkLatestVersion,    // Non-blocking: check for updates
 	}
 	if m.ctx.Config.AnimationsEnabled() {
 		cmds = append(cmds, m.animationTickCmd())
@@ -366,6 +368,12 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		}
 		return m, nil
 
+	case latestVersionMsg:
+		if msg.version != "" {
+			m.header.SetUpgradeVersion(msg.version)
+		}
+		return m, nil
+
 	case conversationLoadedMsg:
 		m.conversationView.SetMessages(msg.messages)
 		m.showConversation = true

internal/tui/ui_test.go

@@ -48,7 +48,7 @@ func TestResumeSessionErr_ValidNeedsInputSession(t *testing.T) {
 }
 
 func TestResumeSession_ValidSessionReturnsCmd(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 
 	task := &data.Session{
 		ID:     "test-session-123",
@@ -163,7 +163,7 @@ func TestResumeSessionErr_NormalizesStatusCase(t *testing.T) {
 }
 
 func TestResumeSession_DetailViewResume(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.taskList.SetTasks([]data.Session{
 		{
 			ID:     "local-1",
@@ -182,7 +182,7 @@ func TestResumeSession_DetailViewResume(t *testing.T) {
 }
 
 func TestResumeSession_LogViewResume(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.taskList.SetTasks([]data.Session{
 		{
 			ID:     "local-1",
@@ -201,7 +201,7 @@ func TestResumeSession_LogViewResume(t *testing.T) {
 }
 
 func TestUpdateFooterHints_DetailViewShowsResumeForResumableSession(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.viewMode = ViewModeDetail
 	m.taskList.SetTasks([]data.Session{
 		{
@@ -224,7 +224,7 @@ func TestUpdateFooterHints_DetailViewShowsResumeForResumableSession(t *testing.T
 }
 
 func TestCycleFilterForwardAndBackward(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	// New order: attention → active → completed → failed → all
 	m.ctx.StatusFilter = "attention"
 
@@ -250,7 +250,7 @@ func TestCycleFilterForwardAndBackward(t *testing.T) {
 }
 
 func TestHandleListKeys_AJumpsToAttention(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.ctx.StatusFilter = "active" // start on a different tab
 
 	updated, cmd := m.handleListKeys(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune{'a'}})
@@ -264,7 +264,7 @@ func TestHandleListKeys_AJumpsToAttention(t *testing.T) {
 }
 
 func TestHandleListKeys_AJumpsToAttentionFromAttention(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.ctx.StatusFilter = "attention"
 
 	updated, cmd := m.handleListKeys(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune{'a'}})
@@ -278,7 +278,7 @@ func TestHandleListKeys_AJumpsToAttentionFromAttention(t *testing.T) {
 }
 
 func TestHandleListKeys_LocalSessionLogSwitchesToLogView(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.taskList.SetTasks([]data.Session{
 		{
 			ID:         "local-1",
@@ -301,15 +301,15 @@ func TestHandleListKeys_LocalSessionLogSwitchesToLogView(t *testing.T) {
 }
 
 func TestView_NotReadyShowsStartupText(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	view := m.View()
 	if view != "Loading sessions..." {
 		t.Fatalf("expected startup text, got %q", view)
 	}
 }
 
 func TestUpdateFooterHints_LocalSessionShowsOnlyAvailableActions(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.viewMode = ViewModeList
 	m.taskList.SetTasks([]data.Session{
 		{
@@ -332,7 +332,7 @@ func TestUpdateFooterHints_LocalSessionShowsOnlyAvailableActions(t *testing.T) {
 }
 
 func TestUpdateFooterHints_AgentSessionWithoutPRHidesOpenPRHint(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.viewMode = ViewModeList
 	m.taskList.SetTasks([]data.Session{
 		{
@@ -356,7 +356,7 @@ func TestUpdateFooterHints_AgentSessionWithoutPRHidesOpenPRHint(t *testing.T) {
 }
 
 func TestHandleLogKeys_FTogglesFollowMode(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.taskList.SetTasks([]data.Session{
 		{
 			ID:     "agent-1",
@@ -383,7 +383,7 @@ func TestHandleLogKeys_FTogglesFollowMode(t *testing.T) {
 }
 
 func TestHandleLogKeys_ScrollUpPausesFollowMode(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.viewMode = ViewModeLog
 	m.logView.SetLive(true)
 	m.logView.SetFollowMode(true)
@@ -396,7 +396,7 @@ func TestHandleLogKeys_ScrollUpPausesFollowMode(t *testing.T) {
 }
 
 func TestHandleLogKeys_GotoBottomEnablesFollowMode(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.viewMode = ViewModeLog
 	m.logView.SetLive(true)
 	m.logView.SetFollowMode(false)
@@ -409,7 +409,7 @@ func TestHandleLogKeys_GotoBottomEnablesFollowMode(t *testing.T) {
 }
 
 func TestHandleLogKeys_EscClearsLiveMode(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.viewMode = ViewModeLog
 	m.logView.SetLive(true)
 	m.logView.SetFollowMode(true)
@@ -439,7 +439,7 @@ func TestIsSessionRunning(t *testing.T) {
 }
 
 func TestView_LoadingScreenShownBeforeDataLoads(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	// Simulate terminal sizing (sets ready = true)
 	m.ready = true
 	m.ctx.Width = 80
@@ -466,7 +466,7 @@ func TestView_LoadingScreenShownBeforeDataLoads(t *testing.T) {
 }
 
 func TestView_LoadingScreenTransitionsAfterInitialLoad(t *testing.T) {
-	m := NewModel("", false, true, "") // demo mode for simplicity
+	m := NewModel("", false, true, "", "dev") // demo mode for simplicity
 	m.ready = true
 	m.ctx.Width = 120
 	m.ctx.Height = 40
@@ -488,7 +488,7 @@ func TestLoadingTaglines_NotEmpty(t *testing.T) {
 }
 
 func TestHandleListKeys_GOpensGitActivity(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.taskList.SetTasks([]data.Session{
 		{
 			ID:      "local-1",
@@ -510,7 +510,7 @@ func TestHandleListKeys_GOpensGitActivity(t *testing.T) {
 }
 
 func TestHandleListKeys_GToastsForNonLocalSession(t *testing.T) {
-	m := NewModel("", false, false, "")
+	m := NewModel("", false, false, "", "dev")
 	m.taskList.SetTasks([]data.Session{
 		{
 			ID:     "agent-1",