Sazabi
Sandbox CLIs

Dagster

Give the Sazabi agent the Dagster CLI (dg) in its sandbox to inspect Dagster+ runs, assets, jobs, and schedules.

About

This CLI connection makes the Dagster CLI (dg) available in the Sazabi agent's sandbox. The agent can use it for inspecting Dagster+ runs, assets, jobs, and schedules. The tool is baked into the sandbox image; connecting it authenticates the already-installed CLI.

Prerequisites

  • A Sazabi project.
  • A Dagster+ API token (DAGSTER_CLOUD_API_TOKEN), created from your Dagster+ organization settings.
  • Your Dagster Cloud organization name (DAGSTER_CLOUD_ORGANIZATION).

Set up in the dashboard

Configure the sandbox in the dashboard under Settings > Sandbox CLIs.

Find Dagster in the catalog

In Settings > Sandbox CLIs, find Dagster under Browse sandbox CLIs and choose to connect it.

Provide credentials

Enter the required values: DAGSTER_CLOUD_API_TOKEN — your Dagster+ API token; DAGSTER_CLOUD_ORGANIZATION — the slug of your Dagster+ organization. Optionally, set DAGSTER_CLOUD_DEPLOYMENT to target a specific deployment name (defaults to the production deployment if omitted). Save to store them securely; Sazabi injects them into the sandbox when the agent runs.

Set up with the CLI

You can also configure the Dagster CLI connection with the Sazabi CLI (installed and authenticated — see CLI reference).

sazabi sandbox-clis set --type dagster --env DAGSTER_CLOUD_API_TOKEN=<your-dagster-token> --env DAGSTER_CLOUD_ORGANIZATION=<your-org>

To validate the credentials without saving, run the same command with test in place of set (the test command also requires the --env flags).

Verify

Ask the agent, in a thread, to run the dg CLI (a read-only or status command) and confirm it returns real output from your account. If the command is not found, the CLI connection may not be enabled; if it runs unauthenticated, recheck the credentials.

Troubleshooting

Command not found — Confirm the Dagster CLI connection is enabled for the project under Settings > Sandbox CLIs.

Authentication fails — Recheck the credential values; a rotated or revoked token must be re-entered under Settings > Sandbox CLIs or with sazabi sandbox-clis set --type dagster.

Further reading