| name | ci-check |
| description | Run local CI checks and verify GitHub Actions status. Use before committing, after pushing, or when asked to check/fix CI. |
CI Check
Run CI checks locally first, then verify GitHub Actions if the branch has been pushed.
Step 1: Run local CI
Run ./scripts/ci-local.sh to execute the same checks as GitHub Actions: install, build, typecheck, and docker build. If any step fails, fix it before proceeding.
Use ./scripts/ci-local.sh --quick to skip the docker build when iterating on TypeScript fixes.
Step 2: Check remote CI (if pushed)
Run gh run list --branch $(git branch --show-current) --limit 1 to find the most recent CI run for this branch. If no runs exist, the branch hasn't been pushed yet — tell the user.
If the run status is completed and conclusion is success, report that CI is green and stop.
If the run is in_progress, run gh run watch <run-id> to wait for completion. Then re-check.
If the run failed, proceed to Step 3.
Step 3: Read the failure logs
Run gh run view <run-id> --log-failed to get only the log lines from failed steps. This is more focused than --log which dumps everything.
Identify which step failed:
pnpm install --frozen-lockfile — lockfile out of syncpnpm turbo build — TypeScript compilation errorpnpm turbo typecheck — type errors without builddocker build — Dockerfile issue
Step 4: Fix locally
Based on the failure:
Lockfile drift: Run pnpm install locally and commit the updated pnpm-lock.yaml.
Build/typecheck failure: Read the error, find the file and line, fix the issue. Run ./scripts/ci-local.sh --quick to verify before pushing.
Docker build failure: Read the error. Common causes: missing COPY for a new config file, changed package name, missing dependency. Run ./scripts/ci-local.sh (full) to verify.
Step 5: Push and re-check
After fixing, push the branch and run Step 2 again. Repeat until CI is green.
Commands Reference
| Command | Purpose |
|---|
./scripts/ci-local.sh | Full local CI (install, build, typecheck, docker) |
./scripts/ci-local.sh --quick | Local CI without docker build |
gh run list --branch <branch> --limit 5 | List recent runs for a branch |
gh run view <id> | Summary of a specific run |
gh run view <id> --log-failed | Only failed step logs |
gh run watch <id> | Wait for an in-progress run |
