Access to the Rippling CLI is gated behind the Developer Program, which is currently in a closed beta.

Sign in

rippling login

Signs the user in.

Flag	Type	Required	Description
--no-default	boolean	no	Keep the current default context.

Example:

rippling login
rippling login --no-default

rippling logout

Signs the user out.

Flag	Type	Required	Description
—	—	—	No command-specific flags.

Example:

rippling logout

Access

rippling access apply

Submits a Developer Program application.

Flag	Type	Required	Description
--build-description	string	no	What the company plans to build on Rippling.
--entrypoint	string	no	Apply entrypoint. Allowed values: llm_cli_apply, web_apply.
--input	file	no	Full JSON body from a file, or stdin with -. Leave field flags off when you use --input.
--json	boolean	no	Print the response as indented JSON.

Example:

rippling access apply
rippling access apply --build-description "Peer recognition workflows" --json

rippling access status

Reads the company’s Developer Program application status.

Flag	Type	Required	Description
--json	boolean	no	Print the response as indented JSON.

Example:

rippling access status
rippling access status --json

Contexts

rippling config create

Creates an API-token context. Use your company as the company_id, and pipe RIPPLING_API_TOKEN directly into the command.

Flag	Type	Required	Description
--company-id	string	no	Rippling company ID.
--description	string	no	Context description.
--token-stdin	boolean	no	Read the API token from standard input.

Example:

printf '%s' "$RIPPLING_API_TOKEN" | rippling config create --context developer-account --company-id company_id --description "Developer account" --token-stdin

rippling config show

Shows the saved config.

Flag	Type	Required	Description
—	—	—	No command-specific flags. Config is read from RIPPLING_HOME, or ~/.rippling when that variable is unset.

Example:

rippling config show

rippling config context list

Lists saved contexts.

Flag	Type	Required	Description
--json	boolean	no	Print the context list as JSON.

Example:

rippling config context list
rippling config context list --json

--json prints a list of contexts. A developer-account entry looks like this:

{
  "contexts": [
    {
      "name": "developer-account",
      "default": true,
      "authMode": "developer-account"
    }
  ]
}

rippling config context get

Reads one saved context. Select it with --context. The JSON includes companyID.

Flag	Type	Required	Description
--json	boolean	no	Print the context as JSON.

Example:

rippling config context get --context sandbox-editor --json

rippling config context delete

Deletes the context selected with --context.

Flag	Type	Required	Description
—	—	—	No command-specific flags. Pass the context with --context.

Example:

rippling config context delete --context sandbox-editor

rippling config default-context set

Sets the persisted default context to the context named by --context.

Flag	Type	Required	Description
—	—	—	No command-specific flags.

Example:

rippling config default-context set --context developer-account

rippling config default-context show

Shows the persisted default context.

Flag	Type	Required	Description
--json	boolean	no	Print the default context as JSON.

Example:

rippling config default-context show
rippling config default-context show --json