From 98b9bc3c934f0505372e44a139b69e2f2f7c1366 Mon Sep 17 00:00:00 2001 From: Jason Woltje Date: Tue, 24 Feb 2026 12:54:33 -0600 Subject: [PATCH] docs: document Woodpecker multi-instance usage and instance-to-repo mapping Agents had no guidance on which Woodpecker instance serves which repos, leading to repeated 401 failures and workaround attempts. Co-Authored-By: Claude Opus 4.6 --- TOOLS.md | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) 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 ` 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 +# 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 ` selects a named instance (e.g. `personal`, `work`). Omit `-a` to use the default from `cloudflare.default` in credentials.json.