secret get

Retrieve details about a secret stored in AWS Secrets Manager. The command prints the secret's name, creation date and ARN. It prints the value only with --show-secrets; otherwise the value is <<OMITTED>>. Use this to verify a secret before referencing it in your Stacktape configuration with the $Secret() directive.

Usage

stacktape secret get --region eu-west-1

In interactive mode, you are prompted to enter the secret name. In agent mode, pass the secret name as an argument:

stacktape secret get my-api-key --region eu-west-1 --agent

API reference

stacktape secret get <secret-name>CLI options
-r, --regionrequired"us-east-2" | "us-east-1" | "us-west-1" | "us-west-2" | "ap-east-1" | "ap-south-1" | "ap-northeast-3" | "ap-northeast-2" | "ap-southeast-1" | "ap-southeast-2" | "ap-northeast-1" | "ca-central-1" | "eu-central-1" | "eu-west-1" | "eu-west-2" | "eu-west-3" | "eu-north-1" | "me-south-1" | "sa-east-1" | "af-south-1" | "eu-south-1"

AWS Region

The AWS region for the operation. For a list of available regions, see the AWS documentation.

Inside a project whose config declares region, the flag is optional and overrides the config.

--aws-accountstring

AWS Account

The name of the AWS account to use for the operation. The account must first be connected in the Stacktape Console.

Without it, the account is chosen by --profile, AWS_PROFILE or AWS credentials in environment variables, then by your saved default, then by your organization's only connected account. --aws-account takes precedence over all of them, but AWS credentials in environment variables must then belong to that account.

-h, --helpstring

Show Help

If provided, the command will not execute and will instead print help information.

--log-level"info" | "debug" | "error"

Log Level

The level of logs to print to the console.

  • info: Basic information about the operation.
  • error: Only errors.
  • debug: Detailed information for debugging.
-p, --profilestring

AWS Profile

The AWS profile to use for the command. You can manage profiles using the aws-profile:* commands and set a default profile with defaults set.

For commands that use a connected AWS account, --profile (or AWS_PROFILE) selects the connected account the profile belongs to, unless --aws-account is set. The command fails if that account is not connected.

--quietboolean

Quiet

Hide progress, banners, success messages and hints. Command output, warnings and errors are still printed.

--secret-name (positional 1)string

Secret Name

The name of the secret in AWS Secrets Manager.

--show-secretsboolean

Show Secrets

If true, the command includes secret values in its output: database passwords, connection strings with credentials and other stack parameters Stacktape stores as sensitive, and the value a secret get reads. Without it, each of them is <> in the terminal, in JSON output and in the stack-info file. Use it only where the output stays private, never in shared CI logs.

Output

In interactive mode, the command prints a formatted box containing the secret's name, creation date, ARN, and value. If the value is valid JSON, it is pretty-printed.

With --agent, the final result event contains name, arn, created (an ISO 8601 timestamp) and value at data.result. The shared CLI --agent flag also disables interactive prompts, so pass the secret name when using it.

Without --show-secrets, value is <<OMITTED>> in both modes. Pass the flag only where the output stays private: never in a shared CI log or an AI assistant's conversation. The MCP server never returns the value.

Examples

Retrieve a secret interactively (you'll be prompted for the name):

stacktape secret get --region us-east-1

Check that a secret exists, without printing its value:

stacktape secret get DATABASE_PASSWORD --region eu-west-1 --agent

Print the value in your own terminal:

stacktape secret get DATABASE_PASSWORD --region eu-west-1 --show-secrets

Use a named AWS profile:

stacktape secret get --region eu-west-1 --profile production