client list-pending

• Usage: client list-pending [OPTIONS] -K <SECRET_KEY>
• Source: src/commands/list_pending.rs

List all files on the backend that still need your signature. The command authenticates with your secret key and returns only the files where your public key is among the expected signers.

Options

-K --secret-key <PATH>

Path to your secret key file. Required.

-p --password <PASSWORD>

Password for the secret key. Conflicts with --password-file. Prompted interactively if neither is set.

-P --password-file <PATH>

File containing the password. Conflicts with --password.

-u --backend-url <URL>

Backend API URL. Defaults to http://127.0.0.1:3000.

--json

Emit the backend response as JSON instead of human-readable text.

Environment

• ASFALOAD_LIST_PENDING_PASSWORD — alternative to --password.
• ASFALOAD_LIST_PENDING_PASSWORD_FILE — alternative to --password-file.

Output

Human-readable (default), when files are pending:

Files requiring your signature:
  - https/github.com/443/acme/repo/releases/tag/v1.0/asfaload.index.json
  - https/github.com/443/acme/repo/releases/tag/v2.0/asfaload.index.json

When nothing is pending:

No pending signatures found.

JSON (with --json):

{"file_paths":["https/github.com/443/acme/repo/releases/tag/v1.0/asfaload.index.json"]}

Examples

# list pending files
client list-pending -K ~/.asfaload/key.minisign

# non-interactive, piped into sign-pending
client list-pending --json -K ~/.asfaload/key.minisign -p "$PASSWORD" \
    | jq -r '.file_paths[]'

Exit codes

• 0 — query succeeded (even if no files are pending).
• non-zero — error (authentication failure, network error).