Skip to content
Cisco AI Defense logo
CiscoAI Security

defenseclaw keys — DefenseClaw

Overview

defenseclaw keys — Inspect and manage DefenseClaw API keys.

Reference

Synopsis

defenseclaw keys [OPTIONS]

Subcommands

SubcommandDescription
checkExit 0 when all REQUIRED keys are set, non-zero otherwise.
fill-missingInteractively prompt for every REQUIRED-but-unset credential.
listList every credential DefenseClaw knows about.
setSet a credential and persist it to ~/.defenseclaw/.env.

Description

Inspect and manage DefenseClaw API keys

defenseclaw keys check

Exit 0 when all REQUIRED keys are set, non-zero otherwise

Exit 0 when all REQUIRED keys are set, non-zero otherwise.

Intended for CI/preflight hooks. Produces a terse summary on stdout and nothing else.

defenseclaw keys fill-missing

Interactively prompt for every REQUIRED-but-unset credential

Options

FlagTypeDefaultEnv varRequiredDescription
--yesbooleannoSkip the confirmation prompt.

defenseclaw keys list

List every credential DefenseClaw knows about

Options

FlagTypeDefaultEnv varRequiredDescription
--jsonbooleannoEmit machine-readable JSON instead of a table.
--show-valuesbooleannoShow masked value previews (still truncated).
--missing-onlybooleannoOnly show credentials that are required by the current config but unset.

defenseclaw keys set

Set a credential and persist it to ~/.defenseclaw/.env

defenseclaw keys set <ENV_NAME>

Arguments

NameTypeArityRequired
env_nametext1yes

Options

FlagTypeDefaultEnv varRequiredDescription
--valuetextnoValue to store; prompts if omitted.

Usage

Inspect required keys

defenseclaw keys list --json
defenseclaw keys list --missing-only

--missing-only is useful in setup scripts that only care about unresolved providers.

Set and verify values

defenseclaw keys set OPENAI_API_KEY --value "$OPENAI_API_KEY"
defenseclaw keys fill-missing --yes
defenseclaw keys check

Prefer environment-backed values in shared machines and CI.

Related