environment Command

The nitro environment commands manage environments. An environment is a workspace-level grouping that holds a list of variables that can be reused across documents in the Nitro UI.

All environment commands require authentication. Run nitro login first or pass --api-key (see Global Options).

`nitro environment create`

Create a new environment in a workspace.

nitro environment create --name "<name>"

Options

Option	Env	Description
`-n, --name <name>`		Display name of the environment (for example `dev`, `staging`, `production`). Required.
`--workspace-id <workspace-id>`	`NITRO_WORKSPACE_ID`	ID of the workspace to create the environment in. Falls back to the workspace from the current session.

When run interactively without --name, the CLI prompts for it.

Examples

Create an environment in the current workspace:

nitro environment create --name "<name>"

Create an environment in a specific workspace:

nitro environment create \
  --name "<name>" \
  --workspace-id "<workspace-id>"

`nitro environment list`

List all environments in a workspace. Results are paginated, use the returned cursor to fetch the next page.

nitro environment list

Options

Option	Env	Description
`--workspace-id <workspace-id>`	`NITRO_WORKSPACE_ID`	ID of the workspace. Falls back to the workspace from the current session.
`--cursor <cursor>`	`NITRO_CURSOR`	Pagination cursor to resume from. Useful for non-interactive paging.

`nitro environment show`

Show the details of an environment by its ID.

nitro environment show "<environment-id>"

Arguments

Argument	Description
`<id>`	ID of the environment to show. Required.

Last updated on May 13, 2026 by Michael Staib