You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
If the repository root contains an [`aw.yml` manifest](/gh-aw/reference/aw-yml-package-manifest/), `gh aw compile` validates it before compiling workflows.
**`--approve` flag:** When compiling a workflow that already has a lock file, the compiler enforces *safe update mode* — any newly added secrets or custom actions not present in the previous manifest require explicit approval. Pass `--approve` to accept these changes and regenerate the manifest baseline. On first compile (no existing lock file), enforcement is skipped automatically and `--approve` is not needed.
295
295
@@ -350,7 +350,7 @@ gh aw trial ./workflow.md --host-repo owner/repo # Run directly in repository
350
350
gh aw trial ./workflow.md --dry-run # Preview without executing
**Secret Handling:** API keys required for the selected engine are automatically checked. If missing from the target repository, they are prompted for interactively and uploaded.
356
356
@@ -434,13 +434,13 @@ gh aw logs "CI Failure Doctor" # Display name
434
434
gh aw logs "ci failure doctor" # Case-insensitive display name
435
435
```
436
436
437
-
**`--after` flag (cache cleanup):** Deletes cached run folders in the output directory whose run creation date is older than the specified cutoff. Accepts the same date/time delta formats as `--start-date` and `--end-date` (e.g. `-1d`, `-1w`, `-1mo`) as well as absolute dates (`YYYY-MM-DD`). Cleanup runs before the download step to free disk space first; failures are non-fatal and logged as warnings.
437
+
**`--cache-before` flag (cache cleanup):** Deletes cached run folders in the output directory whose run creation date is older than the specified cutoff. Accepts the same date/time delta formats as `--start-date` and `--end-date` (e.g. `-1d`, `-1w`, `-1mo`) as well as absolute dates (`YYYY-MM-DD`). Cleanup runs before the download step to free disk space first; failures are non-fatal and logged as warnings. The previous `--after` spelling is kept as a hidden, deprecated alias.
438
438
439
439
```bash wrap
440
-
gh aw logs --after -1w # Clean folders older than 1 week, then download latest runs
441
-
gh aw logs --after -30d # Clean folders older than 30 days
442
-
gh aw logs --after 2024-01-01 # Clean folders from before a specific date
443
-
gh aw logs my-workflow --after -1mo -c 20 # Clean up, then download 20 runs of a specific workflow
440
+
gh aw logs --cache-before -1w # Clean folders older than 1 week, then download latest runs
441
+
gh aw logs --cache-before -30d # Clean folders older than 30 days
442
+
gh aw logs --cache-before 2024-01-01 # Clean folders from before a specific date
443
+
gh aw logs my-workflow --cache-before -1mo -c 20 # Clean up, then download 20 runs of a specific workflow
444
444
```
445
445
446
446
Only directories matching the `run-{ID}` naming pattern inside the output directory are considered. The run's creation timestamp is read from `run_summary.json` inside each folder; if that file is absent (e.g., incomplete download), the directory's modification time is used as a fallback.
@@ -460,7 +460,7 @@ echo "1234567890" | gh aw logs --stdin --engine claude
460
460
cat run-ids.txt | gh aw logs --stdin --repo owner/repo # required for bare numeric IDs
The `--no-redirect` flag causes `update` to fail when the source workflow has a [`redirect`](/gh-aw/reference/frontmatter/) field, rather than following the redirect to its new location. Use this when you want explicit control over redirect handling.
665
665
@@ -691,7 +691,7 @@ gh aw upgrade --audit # Run dependency health audit
691
691
gh aw upgrade --audit --json # Dependency audit in JSON format
0 commit comments