From 5474819ebf7a440567a0c0aada1a51ea3e2c7370 Mon Sep 17 00:00:00 2001
From: Donald Campbell <125581724+donaldcampbelljr@users.noreply.github.com>
Date: Mon, 6 Oct 2025 12:56:52 -0600
Subject: [PATCH] add clairty on looper check

---
 docs/looper/how-to/rerun.md | 17 ++++++++++++++++-
 mkdocs.yml                  |  2 +-
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/docs/looper/how-to/rerun.md b/docs/looper/how-to/rerun.md
index c35cf974..7060693b 100644
--- a/docs/looper/how-to/rerun.md
+++ b/docs/looper/how-to/rerun.md
@@ -34,8 +34,23 @@ currentPipestatManager.set_status(record_identifier="sample2", status_identifier
 ```
 More info on setting status can be found [here](../developer-tutorial/developer-pipestat.md#setting-and-checking-status).
 
+Now that your pipeline is setting statuses, you can check the status of all samples using:
+```shell
+looper check
+```
+This command will show you a list of samples and their associated status,e.g:
+
+```
+     'count_lines' pipeline status summary     
+┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃    Status     ┃    Jobs count/total jobs    ┃
+┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
+│   completed   │             1/3             │
+│    failed     │             2/3             │
+└───────────────┴─────────────────────────────┘
+```
 
-Now that your pipeline is setting statuses, you can resubmit failed jobs with:
+You can resubmit all failed jobs with:
 ```shell
 looper rerun
 ```
diff --git a/mkdocs.yml b/mkdocs.yml
index 122e42d4..5b12fc8f 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -153,7 +153,7 @@ nav:
         - Running project-level pipelines: looper/how-to/project-level-pipelines.md
         - Link similar results: looper/how-to/link-objects.md
         - Report objects:  looper/how-to/report-objects.md
-        - Rerun samples: looper/how-to/rerun.md
+        - Check status and rerun samples: looper/how-to/rerun.md
     - Pipeline Developer Docs:
       - Developer tutorial:
         - Writing a pipeline interface: looper/developer-tutorial/writing-a-pipeline-interface.md