vk status

Usage

vk status [options]

Options

Option	Description	Default
-s, --stage <stage>	Deployment stage	dev

Description

Reports the current deployed state of a stage by querying CloudFormation and Lambda. It prints:

1. CloudFormation Stack — current StackStatus (color-coded) and LastUpdatedTime.
2. Resources — every key/value in the stack’s Outputs (e.g., ApiUrl, UserPoolId, BucketName).
3. Lambda Functions — each function in <project>-<stage>-*, with runtime, memory, and timeout.
4. API URL — convenience line showing the ApiUrl output if present.

If the stack does not exist, vk status prints a hint to run vk deploy --stage <stage>.

Examples

# Status for the default dev stage
vk status

# Status for production
vk status --stage prod

Requirements

• An AWS account with credentials in the environment (AWS_PROFILE, AWS_REGION, etc.) or ~/.aws/credentials.
• A previously successful vk deploy --stage <stage> so the CloudFormation stack and Lambda functions exist.
• @aws-sdk/client-cloudformation and @aws-sdk/client-lambda are loaded lazily and bundled with the CLI.

Output

📊 VentureKit Status

   App:    my-app
   Stage:  dev
   Region: eu-west-1
   Stack:  my-app-dev

  CloudFormation Stack
    Status:       UPDATE_COMPLETE
    Last updated: 2026-04-15T10:21:33.000Z

  Resources
    ApiUrl       https://abc123.execute-api.eu-west-1.amazonaws.com
    UserPoolId   eu-west-1_aBcDeFgHi

  Lambda Functions
    routes-health-get
      Runtime: nodejs22.x  Memory: 128MB  Timeout: 10s

  API URL: https://abc123.execute-api.eu-west-1.amazonaws.com

Related

• vk logs — tail CloudWatch logs for the same stack
• vk deploy — deploy a stage
• vk remove — tear a stage down