Configuration Reference
Complete configuration options for Goblin.
Project Configuration
Set via goblin pipeline config:
| Key | Type | Default | Description |
|---|---|---|---|
assignee_user_id | string | null | Linear user ID for auto-assignment |
docker_compose_file | string | docker-compose.yml | Docker Compose file path |
test_urls | string | null | Comma-separated test URLs |
playwright_testing | boolean | false | Enable Playwright |
cloud_provider | string | local | local, ec2, digitalocean |
Linear Notifications
| Key | Type | Default | Description |
|---|---|---|---|
linear_notifications_enabled | boolean | true | Enable Linear updates |
linear_stage_updates_enabled | boolean | true | Post stage completions |
linear_blocker_tagging | boolean | true | Tag users on blockers |
linear_mid_stage_updates | boolean | false | Updates during work |
linear_max_mid_stage_updates | integer | 1 | Max mid-stage updates |
linear_mid_stage_cooldown_minutes | integer | 15 | Cooldown between updates |
Static Analysis
| Key | Type | Default | Description |
|---|---|---|---|
static_analysis_enabled | boolean | true | Run static analysis |
static_analysis_mypy | boolean | true | Include mypy |
EC2 Configuration
| Key | Type | Default | Description |
|---|---|---|---|
aws_region | string | us-east-1 | AWS region |
ec2_instance_type | string | t3.small | Instance type |
ec2_key_name | string | null | SSH key name |
ec2_security_group | string | null | Security group ID |
ssh_key_path | string | null | Local SSH key path |
DigitalOcean Configuration
| Key | Type | Default | Description |
|---|---|---|---|
do_region | string | nyc1 | DO region |
do_size | string | s-1vcpu-1gb | Droplet size |
do_ssh_key_id | string | null | SSH key ID |
Preview Environment
| Key | Type | Default | Description |
|---|---|---|---|
preview_ttl_minutes | integer | 120 | Preview lifetime |
preview_keep_on_failure | boolean | false | Keep on test failure |
Agent Configuration
| Key | Type | Default | Description |
|---|---|---|---|
agent_timeout_minutes | integer | 60 | Agent timeout |
agent_max_retries | integer | 3 | Max retry attempts |
Pipeline Configuration
| Key | Type | Default | Description |
|---|---|---|---|
pipeline_max_review_iterations | integer | 3 | Max review loops |
pipeline_max_test_iterations | integer | 3 | Max test loops |
Environment Variables
| Variable | Description |
|---|---|
GOBLIN_WORKSPACE | Override workspace path |
LINEAR_API_TOKEN | Linear API token |
AWS_PROFILE | AWS profile name |
AWS_REGION | AWS region |
DO_TOKEN | DigitalOcean API token |
Configuration Priority
- CLI flags (highest)
- Project config (database)
- Global config (
~/.goblin/config.json) - Environment variables
- Default values (lowest)
Example Configuration
# Full project setup
goblin pipeline config -p my-project \
--assignee-id "user-123" \
--docker-compose docker-compose.yml \
--test-urls "http://localhost:3000" \
--playwright \
--config cloud_provider=ec2 \
--config aws_region=us-east-1 \
--config ec2_instance_type=t3.small \
--config linear_notifications_enabled=true \
--config static_analysis_enabled=true
Viewing Configuration
# Show all config
goblin pipeline config -p my-project --show