Jido PrBot Sprite Smoke Test — .env contract docs

SPRITE_SMOKE_TEST_ENV.md

Sprite Smoke Test .env Contract

These scripts auto-source jido_lib/.env first, then .env in the workspace root.

Shared keys (all scripts)

Required:

• SPRITES_TOKEN (or pre-authenticated sprite login session)
• GH_TOKEN or GITHUB_TOKEN

Optional:

• SPRITES_BASE_URL

Claude smoke (test_claude_sprite.sh)

Required:

• ANTHROPIC_AUTH_TOKEN (preferred) or ANTHROPIC_API_KEY

Recommended:

• ANTHROPIC_BASE_URL (defaults to https://api.z.ai/api/anthropic if omitted)

Optional:

• CLAUDE_CODE_API_KEY
• ANTHROPIC_DEFAULT_HAIKU_MODEL
• ANTHROPIC_DEFAULT_SONNET_MODEL
• ANTHROPIC_DEFAULT_OPUS_MODEL

Amp smoke (test_amp_sprite.sh)

Required:

• AMP_API_KEY

Optional:

• AMP_URL

Codex smoke (test_codex_sprite.sh)

Required:

• OPENAI_API_KEY

Notes:

• Script bootstraps non-interactive login inside sprite with:
  • printenv OPENAI_API_KEY | codex login --with-api-key

Gemini smoke (test_gemini_sprite.sh)

Required (one of):

• GEMINI_API_KEY (recommended), or
• GOOGLE_API_KEY

Optional Vertex mode keys:

• GOOGLE_GENAI_USE_VERTEXAI=true
• GOOGLE_CLOUD_PROJECT
• GOOGLE_CLOUD_LOCATION

When GOOGLE_GENAI_USE_VERTEXAI=true, supply either GOOGLE_API_KEY or both GOOGLE_CLOUD_PROJECT and GOOGLE_CLOUD_LOCATION.

OpenCode smoke (test_opencode_sprite.sh)

Required:

• ZAI_API_KEY

Optional:

• ZAI_BASE_URL (defaults to https://api.z.ai/api/anthropic)
• OPENCODE_MODEL (defaults to zai_custom/glm-4.5-air)

Notes:

• Script writes opencode.json inside the sprite repo and configures a custom zai_custom provider using env interpolation ({env:...}), so no interactive opencode auth login is required.