Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLI
Assigneesstack72

Relationships

#597 Docs: vault refresh hooks (--refresh-from, --refresh-ttl, --clear-refresh)

Opened by stack72 · 6/8/2026· Shipped 6/8/2026

Context

PR swamp-club/swamp#1536 added first-class refresh hooks for vault secrets. The manual pages need updating.

Pages to update

reference/vaults.md

  • New CLI flags: --refresh-from, --refresh-ttl, --clear-refresh
  • Refresh-on-read behavior: vault.get() transparently re-runs the refresh command when TTL lapses
  • vault inspect now shows refresh hook config
  • Failure semantics: stale value returned with warning when command fails

how-to/vaults.md

  • How-to for setting up auto-refreshing credentials (gcloud, AWS SSO, kubectl OIDC)
  • Example: swamp vault put my-vault GCP_TOKEN --refresh-from "gcloud auth print-access-token" --refresh-ttl 50m
  • How to remove a refresh hook: --clear-refresh
  • How to inspect: swamp vault inspect my-vault GCP_TOKEN
02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 5 MOREREVIEW+ 3 MOREPR_MERGED+ 1 MORENOTIFICATION_SKIPPED

Shipped

6/8/2026, 10:14:19 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack726/8/2026, 9:39:17 PM

Sign in to post a ripple.