Configuration

Edsger can be configured to match your team's workflow and preferences.

GitHub Integration

Connecting a Repository

1. Navigate to your product settings
2. Click "Connect Repository"
3. Select a repository from your GitHub account or organization

GitHub App vs OAuth

Edsger supports two modes of GitHub integration:

• GitHub App (Recommended): Fine-grained permissions with institutional access. Provides installation-level tokens for repository operations.
• OAuth App: User-based authentication for personal repositories.

The platform auto-selects the best available method per repository.

Environment Variables

For self-hosted deployments, configure the following environment variables:

# Supabase Configuration
SUPABASE_URL=your-supabase-url
SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

# GitHub OAuth App (user authentication)
GITHUB_CLIENT_ID=your-client-id
GITHUB_CLIENT_SECRET=your-client-secret

# GitHub App (repository operations)
GITHUB_APP_ID=your-app-id
GITHUB_APP_PRIVATE_KEY=your-private-key
GITHUB_APP_CLIENT_ID=your-app-client-id
GITHUB_APP_CLIENT_SECRET=your-app-client-secret

# AI APIs
OPENAI_API_KEY=your-openai-key
CLAUDE_API_KEY=your-claude-key
GEMINI_API_KEY=your-gemini-key

Approval Configuration

Configure human approval gates per product:

1. Navigate to product settings > Approvals
2. Select which phases require approval:
   • Feature Analysis
   • User Stories Analysis
   • Test Cases Analysis
   • Technical Design
   • Branch Planning
   • Functional Testing
3. Assign team members as approvers for each phase
4. Approvers receive email notifications with approve/reject links

Checklist Configuration

Set up quality checklists for development phases:

1. Navigate to product settings > Checklists
2. Create checklists for specific phases and roles
3. Choose item types: boolean, text, number, or select
4. Apply checklist templates for common patterns

Checklists can be scoped to the product (apply to all features) or to individual features.

Notification Settings

Configure notifications for:

• Phase completion emails
• Approval requests
• Chat messages
• Task assignments