GitHub
Give the Sazabi agent the GitHub CLI (gh) in its sandbox to interact with GitHub repositories, pull requests, and issues.
About
This CLI connection makes the GitHub CLI (gh) available in the Sazabi agent's sandbox. Connecting it authenticates the CLI with your GH_TOKEN; repository access through the GitHub App integration is separate and covers the agent's code-search tools. The tool is baked into the sandbox image; connecting it authenticates the already-installed CLI.
Prerequisites
- A Sazabi project.
- A GitHub token (
GH_TOKEN) — either a fine-grained personal access token (PAT) or a GitHub App installation token with access to the repositories the agent needs to read or write.
Set up in the dashboard
Configure the sandbox in the dashboard under Settings > Sandbox CLIs.
Find GitHub in the catalog
In Settings > Sandbox CLIs, find GitHub under Browse sandbox CLIs and choose to connect it.
Provide credentials
Enter the required value: GH_TOKEN — a GitHub personal access token or App installation token with the scopes your agent needs (at minimum repo for repository access). Save to store it securely; Sazabi injects it into the sandbox when the agent runs.
Set up with the CLI
You can also configure the GitHub CLI connection with the Sazabi CLI (installed and authenticated — see CLI reference).
sazabi sandbox-clis set --type github --env GH_TOKEN=<your-github-token>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 gh 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 GitHub 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 github.