← Back to list
01Issue
FeatureShippedSwamp CLIPublicEnterprise
Assigneesstack72
Relationships
#238 vault: add read-secret CLI command for agent-driven secret retrieval
Opened by webframp · 5/5/2026· Shipped 5/6/2026
Feature Request
Currently the vault CLI surface supports:
vault put <vault> <key> [value]— store a secret ✅vault list-keys [vault]— list keys without values ✅vault get <vault>— show vault config (not secrets) ✅- No way to read a secret value via CLI ❌
The error message from vault get test-vault api-key even says:
Unexpected argument: api-key. To retrieve a secret value, use: swamp vault list-keys <vault_name>
But list-keys only shows key names, not values.
Use Case
Agents need to read secrets programmatically for:
- Workflow debugging — verify a secret was stored correctly before running a workflow
- Secret rotation — read old value, generate new, put new, verify
- Cross-vault migration testing — verify migrated secrets match originals
- Composing secrets — read a base URL from vault, append path, use in model input
Proposed API
# Read a single secret value (requires --force or interactive confirm for safety)
swamp vault read <vault_name> <key> --force --json
# Output: { "key": "api-key", "value": "sk-test-...", "vault": "test-vault" }
# Or extend 'vault get' to accept a key:
swamp vault get <vault_name> <key> --jsonSecurity Considerations
- Require explicit
--forceflag (no accidental secret leakage in interactive mode) - In
--jsonmode, mark the value field so log-redaction can scrub it - Consider
--maskedflag that shows first/last 4 chars only (for verification without full exposure) - Audit log entry when a secret is read via CLI
Environment
- swamp version: 20260504.233645.0-sha.430c1535
02Bog Flow
Shipped
Click a lifecycle step above to view its details.
03Sludge Pulse
Sign in to post a ripple.