Package Exports

@sanity/runtime-cli
@sanity/runtime-cli/actions/blueprints
@sanity/runtime-cli/actions/functions
@sanity/runtime-cli/utils

Readme

@sanity/runtime-cli

Sanity's Runtime CLI for Blueprints and Functions

Usage
Commands

Usage

$ npm install -g @sanity/runtime-cli
$ sanity-run COMMAND
running command...
$ sanity-run (--version)
@sanity/runtime-cli/4.4.0 linux-x64 node-v22.15.0
$ sanity-run --help [COMMAND]
USAGE
  $ sanity-run COMMAND
...

Commands

sanity-run blueprints add TYPE
sanity-run blueprints config
sanity-run blueprints deploy
sanity-run blueprints destroy
sanity-run blueprints info
sanity-run blueprints init
sanity-run blueprints logs
sanity-run blueprints plan
sanity-run blueprints stacks
sanity-run functions dev
sanity-run functions env add NAME KEY VALUE
sanity-run functions env list NAME
sanity-run functions env remove NAME KEY
sanity-run functions invoke NAME
sanity-run functions logs NAME
sanity-run functions test NAME
sanity-run help [COMMAND]

`sanity-run blueprints add TYPE`

Add a resource to a Blueprint

USAGE
  $ sanity-run blueprints add TYPE [--function-type document-publish -n <value>]

ARGUMENTS
  TYPE  (function) Type of resource to add (e.g. function)

FLAGS
  -n, --name=<value>            Name of the resource to add
      --function-type=<option>  Type of function to add (e.g. document-publish)
                                <options: document-publish>

DESCRIPTION
  Add a resource to a Blueprint

EXAMPLES
  $ sanity-run blueprints add function

  $ sanity-run blueprints add function --name my-function

  $ sanity-run blueprints add function --name my-function --function-type document-publish

See code: src/commands/blueprints/add.ts

`sanity-run blueprints config`

View or edit Blueprint configuration

USAGE
  $ sanity-run blueprints config [-t] [--project-id <value> -e] [--stack-id <value> ]

FLAGS
  -e, --edit                Edit the configuration
  -t, --test-config         Validate the configuration
      --project-id=<value>  Update the Project ID in the configuration. Requires --edit flag
      --stack-id=<value>    Update the Stack ID in the configuration. Requires --edit flag

DESCRIPTION
  View or edit Blueprint configuration

EXAMPLES
  $ sanity-run blueprints config

  $ sanity-run blueprints config --test-config

  $ sanity-run blueprints config --edit

  $ sanity-run blueprints config --edit --project-id <projectId> --stack-id <stackId>

See code: src/commands/blueprints/config.ts

`sanity-run blueprints deploy`

Deploy a Blueprint

USAGE
  $ sanity-run blueprints deploy [--no-wait]

FLAGS
  --no-wait  Do not wait for deployment to complete

DESCRIPTION
  Deploy a Blueprint

EXAMPLES
  $ sanity-run blueprints deploy

See code: src/commands/blueprints/deploy.ts

`sanity-run blueprints destroy`

Destroy a deployed Blueprint Stack

USAGE
  $ sanity-run blueprints destroy [--id <value>] [--force]

FLAGS
  --force       Force destroy (skip confirmation)
  --id=<value>  Stack ID to destroy (defaults to current Stack)

DESCRIPTION
  Destroy a deployed Blueprint Stack

EXAMPLES
  $ sanity-run blueprints destroy

  $ sanity-run blueprints destroy --id ST-a1b2c3

See code: src/commands/blueprints/destroy.ts

`sanity-run blueprints info`

Show information about a deployed Blueprint Stack

USAGE
  $ sanity-run blueprints info [--id <value>]

FLAGS
  --id=<value>  Stack ID to show info for (defaults to current stack)

DESCRIPTION
  Show information about a deployed Blueprint Stack

EXAMPLES
  $ sanity-run blueprints info

  $ sanity-run blueprints info --id ST-a1b2c3

See code: src/commands/blueprints/info.ts

`sanity-run blueprints init`

Initialize a new Blueprint

USAGE
  $ sanity-run blueprints init [--blueprint-type json|js|ts] [--stack-id <value> --project-id <value>] [-n <value> ]

FLAGS
  -n, --stack-name=<value>       Name to use for a NEW Stack
      --blueprint-type=<option>  Blueprint manifest type to use for the Blueprint
                                 <options: json|js|ts>
      --project-id=<value>       Sanity Project ID to use for the Blueprint
      --stack-id=<value>         Existing Stack ID to use for the Blueprint

DESCRIPTION
  Initialize a new Blueprint

EXAMPLES
  $ sanity-run blueprints init

  $ sanity-run blueprints init --blueprint-type <json|js|ts>

  $ sanity-run blueprints init --blueprint-type <json|js|ts> --project-id <projectId> --stack-id <stackId>

  $ sanity-run blueprints init --blueprint-type <json|js|ts> --project-id <projectId> --stack-name <stackName>

See code: src/commands/blueprints/init.ts

`sanity-run blueprints logs`

Display logs for a Blueprint stack

USAGE
  $ sanity-run blueprints logs [-w]

FLAGS
  -w, --watch  Watch for new logs (streaming mode)

DESCRIPTION
  Display logs for a Blueprint stack

EXAMPLES
  $ sanity-run blueprints logs

  $ sanity-run blueprints logs --watch

See code: src/commands/blueprints/logs.ts

`sanity-run blueprints plan`

Enumerate resources to be deployed - will not modify any resources

USAGE
  $ sanity-run blueprints plan

DESCRIPTION
  Enumerate resources to be deployed - will not modify any resources

EXAMPLES
  $ sanity-run blueprints plan

See code: src/commands/blueprints/plan.ts

`sanity-run blueprints stacks`

List all Blueprint stacks

USAGE
  $ sanity-run blueprints stacks [--projectId <value>]

FLAGS
  --projectId=<value>  Project ID to show stacks for

DESCRIPTION
  List all Blueprint stacks

EXAMPLES
  $ sanity-run blueprints stacks

  $ sanity-run blueprints stacks --projectId a1b2c3

See code: src/commands/blueprints/stacks.ts

`sanity-run functions dev`

Start the Sanity Function emulator

USAGE
  $ sanity-run functions dev [-p <value>]

FLAGS
  -p, --port=<value>  Port to start emulator on

DESCRIPTION
  Start the Sanity Function emulator

EXAMPLES
  $ sanity-run functions dev --port 8974

See code: src/commands/functions/dev.ts

`sanity-run functions env add NAME KEY VALUE`

Add or set the value of an environment variable for a Sanity function

USAGE
  $ sanity-run functions env add NAME KEY VALUE

ARGUMENTS
  NAME   The name of the Sanity Function
  KEY    The name of the environment variable
  VALUE  The value of the environment variable

DESCRIPTION
  Add or set the value of an environment variable for a Sanity function

EXAMPLES
  $ sanity-run functions env add MyFunction API_URL https://api.example.com/

See code: src/commands/functions/env/add.ts

`sanity-run functions env list NAME`

List the environment variables for a Sanity function

USAGE
  $ sanity-run functions env list NAME

ARGUMENTS
  NAME  The name of the Sanity Function

DESCRIPTION
  List the environment variables for a Sanity function

EXAMPLES
  $ sanity-run functions env list MyFunction

See code: src/commands/functions/env/list.ts

`sanity-run functions env remove NAME KEY`

Remove an environment variable for a Sanity function

USAGE
  $ sanity-run functions env remove NAME KEY

ARGUMENTS
  NAME  The name of the Sanity Function
  KEY   The name of the environment variable

DESCRIPTION
  Remove an environment variable for a Sanity function

EXAMPLES
  $ sanity-run functions env remove MyFunction API_URL

See code: src/commands/functions/env/remove.ts

`sanity-run functions invoke NAME`

Invoke a remote Sanity Function

USAGE
  $ sanity-run functions invoke NAME [-d <value>] [-f <value>]

ARGUMENTS
  NAME  The name of the Sanity Function

FLAGS
  -d, --data=<value>  Data to send to the function
  -f, --file=<value>  Read data from file and send to the function

DESCRIPTION
  Invoke a remote Sanity Function

EXAMPLES
  $ sanity-run functions invoke <name> --data '{ "id": 1 }'

  $ sanity-run functions invoke <name> --file 'payload.json'

See code: src/commands/functions/invoke.ts

`sanity-run functions logs NAME`

Retrieve or delete logs for a Sanity Function

USAGE
  $ sanity-run functions logs NAME [-f [-d | -l <value> | -j]]

ARGUMENTS
  NAME  The name of the Sanity Function

FLAGS
  -d, --delete         Delete all logs for the function
  -f, --force          Skip confirmation for deleting logs
  -j, --json           Return logs in JSON format
  -l, --limit=<value>  [default: 50] Total number of log entries to retrieve

DESCRIPTION
  Retrieve or delete logs for a Sanity Function

EXAMPLES
  $ sanity-run functions logs <name>

  $ sanity-run functions logs <name> --json

  $ sanity-run functions logs <name> --limit 100

  $ sanity-run functions logs <name> --delete

See code: src/commands/functions/logs.ts

`sanity-run functions test NAME`

Invoke a local Sanity Function

USAGE
  $ sanity-run functions test NAME [-d <value>] [-f <value>] [-t <value>] [-a <value>] [--dataset <value>]
    [--project <value>]

ARGUMENTS
  NAME  The name of the Sanity Function

FLAGS
  -a, --api=<value>      Sanity API Version to use
  -d, --data=<value>     Data to send to the function
  -f, --file=<value>     Read data from file and send to the function
  -t, --timeout=<value>  Execution timeout value in seconds
      --dataset=<value>  The Sanity dataset to use
      --project=<value>  The Sanity project to use

DESCRIPTION
  Invoke a local Sanity Function

EXAMPLES
  $ sanity-run functions test <name> --data '{ "id": 1 }'

  $ sanity-run functions test <name> --file 'payload.json'

  $ sanity-run functions test <name> --data '{ "id": 1 }' --timeout 60

See code: src/commands/functions/test.ts

`sanity-run help [COMMAND]`

Display help for sanity-run.

USAGE
  $ sanity-run help [COMMAND...] [-n]

ARGUMENTS
  COMMAND...  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for sanity-run.

See code: @oclif/plugin-help