Sazabi
Sandbox CLIs

PostHog

Give the Sazabi agent the PostHog CLI (posthog-cli) in its sandbox to upload source maps and query PostHog projects.

About

This CLI connection makes the PostHog CLI (posthog-cli) available in the Sazabi agent's sandbox. The agent can use it to upload source maps and query PostHog projects. The tool is baked into the sandbox image; connecting it authenticates (or configures the connection for) the already-installed CLI.

Prerequisites

  • A Sazabi project.
  • A PostHog API key (POSTHOG_CLI_API_KEY) and a PostHog project ID (POSTHOG_CLI_PROJECT_ID). Optionally, a custom PostHog host URL (POSTHOG_CLI_HOST) if you are self-hosting PostHog.

Set up in the dashboard

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

Find PostHog in the catalog

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

Provide credentials

Enter the required values: POSTHOG_CLI_API_KEY (your PostHog personal API key) and POSTHOG_CLI_PROJECT_ID (your PostHog project ID). If you self-host PostHog, also enter POSTHOG_CLI_HOST with your instance URL. 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 PostHog CLI connection with the Sazabi CLI (installed and authenticated — see CLI reference).

sazabi sandbox-clis set --type posthog --env POSTHOG_CLI_API_KEY=<your-posthog-key> --env POSTHOG_CLI_PROJECT_ID=<your-project-id>

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 posthog-cli (a read-only or status command) and confirm it returns real output. If the command is not found, the CLI connection may not be enabled; if it runs unauthenticated or cannot connect, recheck the credentials.

Troubleshooting

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

Authentication or connection fails — Recheck the credential/connection values under Settings > Sandbox CLIs.

Further reading