Skip to content

Configuration Reference

GSD Bot edited this page May 23, 2026 · 1 revision

Configuration Reference

All configuration is provided via environment variables. The recommended approach is to store them in a .env file at the repository root — this file is listed in .gitignore and must never be committed.

GitHub Variables

Name Type Required Default Description
GITHUB_PERSONAL_ACCESS_TOKEN string Yes GitHub Personal Access Token. Required scopes: repo, read:org. Create at https://github.com/settings/tokens

Anthropic Variables

Name Type Required Default Description
ANTHROPIC_API_KEY string Yes Anthropic API key for Claude access. Required for autonomous orchestrator operation. Create at https://console.anthropic.com

Behavior Variables

Name Type Required Default Description
GSD_GITHUB_OWNER string Yes GitHub username or organization that owns the target repository
GSD_GITHUB_REPO string Yes Name of the target repository (without owner prefix)
GSD_REVIEWERS string No "" (empty) Comma-separated GitHub usernames to request as PR reviewers. Leave empty to skip reviewer requests
GSD_AUTO_MERGE bool No false If true, automatically squash-merges the PR after the Documenting state completes
GSD_MCP_BINARY string No auto-discovered Full path to github-mcp-server.exe. If not set, the orchestrator probes parent directories from the current working directory. Set this if auto-discovery fails

Security Note

Store all values in a .env file at the repository root. This file is listed in .gitignore and must never be committed to any repository. The GITHUB_PERSONAL_ACCESS_TOKEN and ANTHROPIC_API_KEY in particular grant significant access — treat them as secrets.

Clone this wiki locally