AgentKit
DocsKitsCLI ReferenceDesktop App
BetaYou are reading docs for the beta channel (3.0.0-beta.15). Features may change before the next stable release.Switch to stable →

secrets

ak secrets grants

List recorded agent grants

Use ak secrets grants for the operation described below. The command help records its arguments, effects, and options.

Command contract

List recorded agent grants

Synopsis

Show every grant recorded under {AGENTKIT_HOME}/secrets/grants.json, which is ~/.agentkit unless AGENTKIT_HOME says otherwise. Grants whose expiry has passed are pruned as they are read, so what this prints is what would actually apply right now. A block outranks any allow on the same scope.

Effects: Reads the grants file. Rows that have already expired are compacted out of it as housekeeping, so a listing can rewrite the file even though it decides nothing. Stored secret values are not read.

Exit status: 0 success, 1 command failure, 2 invalid flags or arguments

ak secrets grants [flags]

Examples

  ak secrets grants           # table
  ak secrets grants --json    # machine-readable

Options

  -h, --help             help for grants
      --json             Emit machine-readable JSON (implies --no-interactive)
      --no-interactive   Disable interactive prompts (CI-safe)
  -q, --quiet            Suppress non-error output on stderr
  -V, --verbose          Extra diagnostic output on stderr (loses to --quiet)
  -y, --yes              Assume yes for all prompts

SEE ALSO

  • ak secrets - Manage named secret values (API keys, tokens)