show branch checks in status views

Status check data was coupled to pull request summaries, leaving branches
without a pull request unable to populate sidebar and dashboard check
indicators. This made check visibility depend on PR creation rather than the
branch commit itself.

Query branch refs alongside pull requests in a batched GraphQL request and
carry checks through dedicated caches and status fields. Prefer PR checks when
available, then fall back to the remote branch tip. Main and master branches
show failures while successful and pending checks stay hidden.

Keep daemon polling bounded to one batched status request per active repository
every 30 seconds, with an immediate refresh only when its branch set changes.
Group linked worktrees by their shared git directory and cache repository
resolution once per process to avoid duplicate GitHub calls.

Render the same checks in sidebar and dashboard views, and include the indicator
in the default tile and horizontal templates. Local-only and unpushed branches
leave the check indicator empty.

Author: raine

CHANGELOG.md

@@ -22,6 +22,11 @@ description: Release notes and version history for workmux
 
 # Changelog
 
+## Unreleased
+
+- Show GitHub checks for remote branches without pull requests in the sidebar and dashboard, with check indicators in the default tile and horizontal sidebar layouts and failure-only indicators on main branches.
+- Batch sidebar GitHub polling across linked worktrees and reuse repository metadata so each repository stays within one status request per polling interval.
+
 ## v0.1.231 (2026-07-28)
 
 - Clear acknowledged waiting or completed statuses from the sidebar immediately when you focus an agent pane.

docs/guide/dashboard/index.md

@@ -40,8 +40,8 @@ See [command reference](/reference/commands/dashboard) for CLI options.
 
 The dashboard has two views, toggled with `Tab`:
 
-- **Agents**: Shows all running agent panes with their status, git info, and live terminal preview
-- **Worktrees**: Shows all git worktrees with branch, PR status, and agent summary. Press `r` to remove a worktree (kills agent, removes worktree, deletes branch).
+- **Agents**: Shows all running agent panes with their status, git info, GitHub branch checks, and live terminal preview
+- **Worktrees**: Shows all git worktrees with branch, PR status, GitHub branch checks, and agent summary. Press `r` to remove a worktree (kills agent, removes worktree, deletes branch).
 
 ## Keybindings (Agents view)
 

docs/guide/sidebar/customization.md

@@ -17,13 +17,13 @@ sidebar:
     tiles:
       - "{primary} {pane_suffix} {fill} {elapsed}"
       - "{secondary} {fill} {git_stats}"
-      - "{pane_title}"
+      - "{pane_title} {fill} {pr_checks}"
 
     # Horizontal mode: one string per visual line in each top bar chip.
     horizontal:
       - "{status_icon} {primary} {pane_suffix} {fill} {elapsed}"
       - "{secondary} {fill} {git_stats}"
-      - "{pane_title}"
+      - "{pane_title} {fill} {pr_checks}"
 ```
 
 The values shown above are also the built-in defaults, so leaving these keys
@@ -53,7 +53,7 @@ sidebars without a restart.
 | `{git_stats}`    | Composite git diff stats: committed (`+1278 -400`), pen icon, uncommitted (`+21`). Self-degrades to fit the space it gets. |
 | `{git_branch}`   | Current branch name. Empty when detached HEAD or git status unavailable.                                                   |
 | `{pr_number}`    | Pull request number as `#123`. Empty when the current branch has no matching PR.                                           |
-| `{pr_checks}`    | Pull request check status icon, with counts when space allows. Empty when no PR or no checks are known.                    |
+| `{pr_checks}`    | GitHub check status for the current remote branch, with counts when space allows. Empty when no checks are known.          |
 | `{git_ahead}`    | Commits ahead of upstream as `↑N` when N greater than 0. Empty when 0 or no upstream.                                      |
 | `{git_behind}`   | Commits behind upstream as `↓N` when N greater than 0. Empty when 0 or no upstream.                                        |
 | `{git_dirty}`    | Diff glyph when the working tree is dirty. Empty when clean.                                                               |
@@ -68,11 +68,15 @@ wrap them with another `↑` / `↓` literal in your template, otherwise a stray
 glyph would remain when the count is zero. The same applies to `{git_dirty}`
 and `{git_conflict}`, which are self-contained glyph indicators.
 
-`{pr_number}` and `{pr_checks}` are populated from the current git branch's
-matching GitHub pull request. They render empty on `main`/`master`, when the
-branch has no PR, when git status is unavailable, or while PR data has not been
-fetched yet. Check status shows an icon and, when space allows, passed/total
-counts for pending or failing checks.
+`{pr_number}` is populated from the current git branch's matching GitHub pull
+request. It renders empty on `main`/`master`, when the branch has no PR, when git
+status is unavailable, or while PR data has not been fetched yet.
+
+`{pr_checks}` is populated from the matching pull request's head commit when a PR
+exists, then from the remote branch tip when the branch has no PR check data.
+On `main` and `master`, only failing checks render. Local-only branches and
+commits that have not been pushed render empty. Check status shows an icon and,
+when space allows, passed/total counts for pending or failing checks.
 
 Unknown tokens or unbalanced braces cause that template section to be rejected
 and the previous valid section (or the built-in default) is kept. The sidebar
@@ -127,7 +131,7 @@ sidebar:
     tiles:
       - "#[fg=cyan,bold]{primary}#[default] {pane_suffix} {fill} {elapsed}"
       - "{secondary} {fill} #[fg=green]{git_stats}#[default]"
-      - "{pane_title}"
+      - "{pane_title} {fill} {pr_checks}"
 ```
 
 Supported attributes are `fg=`, `bg=`, `bold`, `dim`, `italics`,
@@ -259,7 +263,7 @@ sidebar:
     tiles:
       - "{agent_icon} {primary} {pane_suffix} {fill} {elapsed}"
       - "{secondary} {fill} {git_stats}"
-      - "{pane_title}"
+      - "{pane_title} {fill} {pr_checks}"
 ```
 
 Configure only two tile lines and show git stats inline on line one:
@@ -272,7 +276,7 @@ sidebar:
       - "{secondary} {fill} {elapsed}"
 ```
 
-Show pull request number and check status in tile mode:
+Show pull request number and GitHub check status in tile mode:
 
 ```yaml
 sidebar:

src/command/dashboard/app/agents.rs

@@ -7,7 +7,7 @@ use std::time::{SystemTime, UNIX_EPOCH};
 
 use ratatui::style::Style;
 
-use crate::github::PrSummary;
+use crate::github::{CheckSummary, PrSummary};
 use crate::multiplexer::{AgentPane, AgentStatus};
 
 use super::DashboardTab;
@@ -496,23 +496,54 @@ impl App {
         self.pr_statuses.get(repo_root)?.get(branch)
     }
 
+    pub fn get_checks_for_agent(&self, agent: &AgentPane) -> Option<&CheckSummary> {
+        let repo_root = self.repo_roots.get(&agent.path)?;
+        let branch = self.git_statuses.get(&agent.path)?.branch.as_ref()?;
+        self.check_statuses
+            .get(repo_root)?
+            .get(branch)
+            .filter(|summary| summary.should_display_for_branch(branch))
+    }
+
+    pub fn get_checks_for_worktree(
+        &self,
+        worktree: &crate::workflow::types::WorktreeInfo,
+    ) -> Option<&CheckSummary> {
+        let project = agent::extract_project_name(&worktree.path);
+        let repo_root = self
+            .all_worktrees
+            .iter()
+            .find(|candidate| {
+                candidate.is_main && agent::extract_project_name(&candidate.path) == project
+            })
+            .map(|candidate| &candidate.path)?;
+        self.check_statuses
+            .get(repo_root)?
+            .get(&worktree.branch)
+            .filter(|summary| summary.should_display_for_branch(&worktree.branch))
+    }
+
     /// Whether a PR fetch is currently in progress
     pub fn is_pr_fetching(&self) -> bool {
         self.is_pr_fetching.load(Ordering::Relaxed)
     }
 
-    /// Whether any agent has a matching PR (for column visibility)
-    pub fn has_any_pr(&self) -> bool {
-        self.agents
-            .iter()
-            .any(|agent| self.get_pr_for_agent(agent).is_some())
+    /// Whether any agent has a matching PR or GitHub checks.
+    pub fn has_any_github_status(&self) -> bool {
+        self.agents.iter().any(|agent| {
+            self.get_pr_for_agent(agent).is_some() || self.get_checks_for_agent(agent).is_some()
+        })
     }
 
     /// Get PR statuses for caching
     pub fn pr_statuses(&self) -> &HashMap<PathBuf, HashMap<String, PrSummary>> {
         &self.pr_statuses
     }
 
+    pub fn check_statuses(&self) -> &HashMap<PathBuf, HashMap<String, CheckSummary>> {
+        &self.check_statuses
+    }
+
     /// Open the PR associated with the selected agent or worktree in the browser.
     pub fn open_pr_for_selected(&mut self) {
         self.open_pr_url(|url| url.to_string());

src/command/dashboard/app/background.rs

@@ -1,4 +1,4 @@
-//! Background thread spawning for git status and PR status fetches.
+//! Background thread spawning for git and GitHub status fetches.
 
 use std::collections::{HashMap, VecDeque};
 use std::path::PathBuf;
@@ -51,7 +51,7 @@ impl App {
         });
     }
 
-    /// Spawn a background thread to fetch PR status for all repos.
+    /// Spawn a background thread to fetch GitHub status for all repos.
     /// Returns true if a fetch was started, false if one is already in progress.
     pub(super) fn spawn_pr_status_fetch(&self) -> bool {
         // Skip if already fetching
@@ -74,9 +74,6 @@ impl App {
             let Some(ref branch) = status.branch else {
                 continue;
             };
-            if branch == "main" || branch == "master" {
-                continue;
-            }
             if let Some(repo_root) = self.repo_roots.get(&agent.path) {
                 repo_branches
                     .entry(repo_root.clone())
@@ -97,9 +94,6 @@ impl App {
             })
             .collect();
         for wt in &self.all_worktrees {
-            if wt.is_main || wt.branch == "main" || wt.branch == "master" {
-                continue;
-            }
             let project = agent::extract_project_name(&wt.path);
             if let Some(repo_root) = main_paths.get(&project) {
                 repo_branches
@@ -168,13 +162,13 @@ impl App {
                             else {
                                 break;
                             };
-                            match crate::github::list_prs_for_branches(&repo_root, &branches) {
-                                Ok(prs) => {
-                                    let _ = tx.send(AppEvent::PrStatus(repo_root, prs));
+                            match crate::github::list_branch_summaries(&repo_root, &branches) {
+                                Ok(summaries) => {
+                                    let _ = tx.send(AppEvent::GithubStatus(repo_root, summaries));
                                 }
                                 Err(e) => {
                                     tracing::warn!(
-                                        "Failed to fetch PRs for {:?}: {}",
+                                        "Failed to fetch GitHub status for {:?}: {}",
                                         repo_root,
                                         e
                                     );

src/command/dashboard/app/events.rs

@@ -12,14 +12,27 @@ impl App {
             AppEvent::GitStatus(path, status) => {
                 self.git_statuses.insert(path, status);
             }
-            AppEvent::PrStatus(repo_root, prs) => {
-                // Clear stale state when a repo has no PRs, otherwise update
+            AppEvent::GithubStatus(repo_root, summaries) => {
+                let mut prs = std::collections::HashMap::new();
+                let mut checks = std::collections::HashMap::new();
+                for (branch, summary) in summaries {
+                    if let Some(pr) = summary.pr {
+                        prs.insert(branch.clone(), pr);
+                    }
+                    if let Some(check_summary) = summary.checks {
+                        checks.insert(branch, check_summary);
+                    }
+                }
                 if prs.is_empty() {
                     self.pr_statuses.remove(&repo_root);
                 } else {
-                    self.pr_statuses.insert(repo_root, prs);
+                    self.pr_statuses.insert(repo_root.clone(), prs);
+                }
+                if checks.is_empty() {
+                    self.check_statuses.remove(&repo_root);
+                } else {
+                    self.check_statuses.insert(repo_root, checks);
                 }
-                // Re-apply worktree filters to merge new PR data
                 if !self.all_worktrees.is_empty() {
                     self.apply_worktree_filters();
                 }

src/command/dashboard/app/mod.rs

@@ -20,7 +20,7 @@ use std::time::{Duration, SystemTime, UNIX_EPOCH};
 
 use crate::config::Config;
 use crate::git::{self, GitStatus};
-use crate::github::PrSummary;
+use crate::github::{CheckSummary, PrSummary};
 use crate::multiplexer::{AgentPane, Multiplexer};
 use crate::state::StateStore;
 use crate::workflow::types::WorktreeInfo;
@@ -73,6 +73,8 @@ pub struct App {
     pub is_git_fetching: Arc<AtomicBool>,
     /// PR info indexed by repo root, then branch name
     pr_statuses: HashMap<PathBuf, HashMap<String, PrSummary>>,
+    /// GitHub check info indexed by repo root, then branch name
+    check_statuses: HashMap<PathBuf, HashMap<String, CheckSummary>>,
     /// Last PR fetch time
     last_pr_fetch: std::time::Instant,
     /// Flag to prevent concurrent PR fetches
@@ -198,6 +200,7 @@ impl App {
         let launch_session = mux.current_session();
         let git_statuses = git::load_status_cache();
         let pr_statuses = crate::github::load_pr_cache();
+        let check_statuses = crate::github::load_check_cache();
         let hide_stale = load_hide_stale();
         let last_pane_id = load_last_pane_id();
 
@@ -225,6 +228,7 @@ impl App {
             last_git_fetch: std::time::Instant::now() - Duration::from_secs(60),
             is_git_fetching: Arc::new(AtomicBool::new(false)),
             pr_statuses,
+            check_statuses,
             // Set to past to trigger immediate fetch on first refresh
             last_pr_fetch: std::time::Instant::now() - PR_FETCH_INTERVAL,
             is_pr_fetching: Arc::new(AtomicBool::new(false)),

src/command/dashboard/app/types.rs

@@ -4,7 +4,7 @@ use std::collections::{HashMap, HashSet};
 use std::path::PathBuf;
 
 use crate::git::GitStatus;
-use crate::github::{PrListEntry, PrSummary};
+use crate::github::{BranchSummary, PrListEntry};
 use crate::workflow::types::WorktreeInfo;
 
 use super::super::diff::DiffView;
@@ -16,8 +16,8 @@ pub enum AppEvent {
     Terminal(crossterm::event::Event),
     /// Git status update for a worktree path
     GitStatus(PathBuf, GitStatus),
-    /// PR status update for a repo root
-    PrStatus(PathBuf, HashMap<String, PrSummary>),
+    /// GitHub status update for a repo root
+    GithubStatus(PathBuf, HashMap<String, BranchSummary>),
     /// Full worktree list from background fetch
     WorktreeList(Vec<WorktreeInfo>),
     /// Git log preview for a worktree path

src/command/dashboard/mod.rs

@@ -232,8 +232,9 @@ pub fn run(
     // Save git status cache before exiting
     git::save_status_cache(&app.git_statuses);
 
-    // Save PR status cache before exiting
+    // Save GitHub status caches before exiting
     github::save_pr_cache(app.pr_statuses());
+    github::save_check_cache(app.check_statuses());
 
     // Restore terminal
     disable_raw_mode()?;

src/command/dashboard/ui/dashboard.rs

@@ -149,8 +149,8 @@ pub fn render_dashboard(f: &mut Frame, app: &mut App) {
 }
 
 fn render_table(f: &mut Frame, app: &mut App, area: Rect) {
-    // Check if we should show the PR column (only when at least one agent has a PR)
-    let show_pr_column = app.has_any_pr();
+    // Show the GitHub column when at least one agent has a PR or checks.
+    let show_pr_column = app.has_any_github_status();
     let show_check_counts = app.config.dashboard.show_check_counts();
 
     let header = format::resource_table_header(
@@ -249,8 +249,10 @@ fn render_table(f: &mut Frame, app: &mut App, area: Rect) {
             // Get PR status for this agent (only if column is shown)
             let pr_spans = if show_pr_column {
                 let pr = app.get_pr_for_agent(agent);
+                let checks = app.get_checks_for_agent(agent);
                 Some(format_pr_status(
                     pr,
+                    checks,
                     show_check_counts,
                     app.spinner_frame,
                     &app.palette,