Environment Variables Reference
All environment variables recognized by prompts-gpt.
Authentication
| Variable | Description | Default |
|---|
PROMPTS_GPT_TOKEN | Project token for API access | — |
PROMPTS_GPT_API_URL | API base URL | https://prompts-gpt.com |
Provider API Keys
| Variable | Provider | Description |
|---|
OPENAI_API_KEY | Codex | OpenAI API key for Codex CLI |
ANTHROPIC_API_KEY | Claude | Anthropic API key for Claude Code |
GITHUB_TOKEN | Copilot | GitHub token for Copilot CLI |
Runtime Configuration
| Variable | Description | Default |
|---|
PROMPTS_GPT_PROVIDER | Override default provider | config value |
PROMPTS_GPT_MODEL | Override default model | config value |
PROMPTS_GPT_TIMEOUT | Override timeout (seconds) | 900 |
PROMPTS_GPT_ARTIFACTS_DIR | Override artifacts directory | .scripts/runs |
CI/CD
| Variable | Description |
|---|
CI | When set, disables interactive mode |
GITHUB_ACTIONS | Detected as CI environment |
GITLAB_CI | Detected as CI environment |
CIRCLECI | Detected as CI environment |
Debugging
| Variable | Description |
|---|
DEBUG | Enable debug logging (DEBUG=prompts-gpt:*) |
PROMPTS_GPT_VERBOSE | Enable verbose output |
Precedence
Environment variables override config file values. Command-line flags override environment variables.
CLI flags > Environment variables > config.json > Defaults
Examples
# Use a specific token and provider
PROMPTS_GPT_TOKEN=pgpt_abc123 PROMPTS_GPT_PROVIDER=codex \
prompts-gpt run review.md
# Debug mode
DEBUG=prompts-gpt:* prompts-gpt sweep audit.md -n 3
# CI environment
CI=true prompts-gpt run-batch review.md tests.md --provider codex --json
See Also