diff --git a/TOOLS.md b/TOOLS.md
index 249c19c..151ba6f 100644
--- a/TOOLS.md
+++ b/TOOLS.md
@@ -66,12 +66,26 @@ Mosaic wrappers at `~/.config/mosaic/tools/git/*.sh` handle platform detection a
 
 ### CI/CD — Woodpecker
 
+Multi-instance support: `-a <instance>` selects a named instance. Omit `-a` to use the default from `woodpecker.default` in credentials.json.
+
+| Instance | URL | Serves |
+|----------|-----|--------|
+| `mosaic` (default) | ci.mosaicstack.dev | Mosaic repos (git.mosaicstack.dev) |
+| `usc` | ci.uscllc.com | USC repos (git.uscllc.com) |
+
 ```bash
-~/.config/mosaic/tools/woodpecker/pipeline-list.sh
-~/.config/mosaic/tools/woodpecker/pipeline-status.sh
-~/.config/mosaic/tools/woodpecker/pipeline-trigger.sh -b <branch>
+# List recent pipelines
+~/.config/mosaic/tools/woodpecker/pipeline-list.sh [-r owner/repo] [-a instance]
+
+# Check latest or specific pipeline status
+~/.config/mosaic/tools/woodpecker/pipeline-status.sh [-r owner/repo] [-n number] [-a instance]
+
+# Trigger a build
+~/.config/mosaic/tools/woodpecker/pipeline-trigger.sh [-r owner/repo] [-b branch] [-a instance]
 ```
 
+Instance selection rule: match `-a` to the git remote host of the target repo. If the repo is on `git.uscllc.com`, use `-a usc`. If on `git.mosaicstack.dev`, use `-a mosaic` (or omit, since it's the default).
+
 ### DNS — Cloudflare
 
 Multi-instance support: `-a <instance>` selects a named instance (e.g. `personal`, `work`). Omit `-a` to use the default from `cloudflare.default` in credentials.json.